# MPM SDK設定 ## 1. 詳細設定 iOS MPMフレームワークには、様々な設定を提供しています。 ### 収集周期設定 IMQA MPMフレームワークがデータを保存する周期と収集する周期を秒単位で設定することができます。 * **Objective-C設定方法** {% code title="AppDelegate.m" %} ```objectivec IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:@"PROJECT_KEY"]; mpmConfig.dump_interval = 10; // Interval of getting the performance data dump (sec) mpmConfig.save_interval = 60; // Interval of sending performance data to the collection server (sec) ``` {% endcode %} * **Swift設定方法** {% code title="AppDelegate.swift" %} ```swift let mpmConfig = IMQAConfig("") mpmConfig.dump_interval = 10 // Interval of getting the performance data dump (sec) mpmConfig.save_interval = 60 // Interval of sending performance data to the collection server (sec) ``` {% endcode %} ### 収集サーバー設定 {% hint style="warning" %} インストール型で実行された顧客会社では、必ずこの設定をする必要がございます。 {% endhint %} IMQA MPMフレームワークが収集するデータを送る収集サーバーを別途に設定することができます。基本的に、SaaSサービスをご利用中の方は、別途に設定する必要がありません。 * **Objective-C設定方法** {% code title="AppDelegate.m" %} ```objectivec NSString* imqaUrl = @"https://custom-url"; IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:PROJECT_KEY]; mpmConfig.api_url = imqaUrl; ``` {% endcode %} * **Swift設定方法** {% code title="AppDelegate.swift" %} ```swift let imqaUrl = "https://custom-url" let mpmConfig = IMQAConfig(PROJECT_KEY) mpmConfig.api_url = imqaUrl ``` {% endcode %} ### ネットワーク収集設定 IMQA MPMフレームワークでは、ネットワーク収集に対する収集の有無を設定することができます。また、特定のURLに対する収集を無視できる機能を提供しているため、セキュリティが要求されるURLを無視することができます。 * **Objective-C設定方法** {% code title="AppDelegate.m" %} ```objectivec IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:@"PROJECT_KEY"]; mpmConfig.useNetworkCollect = YES; // YES: Collect, NO: Do not collect mpmConfig.ignoreUrl = @[@"https://url1.com", @"http://url.com"]; // An array of specific URLs to ignore ``` {% endcode %} * **Swift設定方法** {% code title="AppDelegate.swift" %} ```swift let mpmConfig = IMQAConfig("") mpmConfig.useNetworkCollect = true // true: Collect, false: Do not collect mpmConfig.ignoreUrl = ["https://url1.com", "http://url.com"] // An array of specific URLs to ignore ``` {% endcode %} ### 収集データ確認 IMQA MPMフレームワークで収集しているデータを確認したい場合は、オプションを通してデータをConsoleで確認することができます。 * **Objective-C設定方法** {% code title="AppDelegate.m" %} ```objectivec IMQAConfig* mpmConfig = [[IMQAConfig alloc] init:@"PROJECT_KEY"]; mpmConfig.downloadDumpData = YES; ``` {% endcode %} * **Swift設定方法** {% code title="AppDelegate.swift" %} ```swift let mpmConfig = IMQAConfig("") mpmConfig.downloadDumpData = true ``` {% endcode %} ## 2. WKWebView設定 IMQA MPMフレームワークは、WKWebViewの性能情報も収集しています。UIWebViewは、Apple社のポリシーによって対応しておりませんのでご注意ください。 ### Web Server (HTML)設定 WKWebViewデータを収集したい場合は、ウェブページにIMQA WebView JavaScriptライブラリを挿入してください。ファイルをダウンロードして、ウェブページから直接パスを追加して使用することもできます。 {% hint style="info" %} MPM / WPM統合を使用する場合のエージェントのインストール方法は、「[IMQA WPM / WCRashインストールガイド > WebAgentのインストール > WPM / MPM 統合使用 (WebAgent+WebviewAgentインストール)](/imqa-guide/jpn/installation/web-wpm-wcrash/webagentnoinsutru.md#2-wpm-mpm-webagentwebviewagentinsutru)」を参照してください。 {% endhint %} {% code title="page.html" %} ```html // If you want to apply it as a min file: ``` {% endcode %} ```html ``` ### iOSプロジェクト設定 性能収集が必要なWebViewに以下のとおり設定してください。また、WebViewで発生したエラー情報を収集することもできます。 Webview Crashを収集するには、ImqaBridgeCrashを追加する必要があります。 * **Objective-C設定方法** {% code title="ViewController.m " %} ```objectivec - (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message { // IMQA settings section if([message.name isEqual: @"ImqaBridge"]) { [[IMQAMpm sharedInstance] saveWebviewPostMessage:self :message.body]; } // Additional setup code (Webview Agent (ver. 1.1.2 later) WebView Crash collection) if(message.name == "ImqaBridgeCrash") { IMQACrash.notifyWebCrash("\(message.body)") } } - (void)viewDidLoad { [super viewDidLoad]; NSURL* url = [[NSURL alloc] initWithString:@""]; NSURLRequest* reqeust = [[NSURLRequest alloc] initWithURL:url]; [_webView loadRequest:request]; [_webView.configuration.userContentController addScriptMessageHandler:self name:@"ImqaBridge"]; } ``` {% endcode %} * **Swift設定方法** {% code title="ViewController.swift" %} ```swift func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) { // IMQA settings section if(message.name == "ImqaBridge") { IMQAMpm.sharedInstance.saveWebviewPostMessage(self,"\(message.body)") } } override func viewDidLoad() { super.viewDidLoad() let request = URLRequest(url: URL(string: url)!) webView.load(request) // IMQA settings section webView.configuration.userContentController.add(self, name: "ImqaBridge") } ``` {% endcode %} ## 3. ネットワーク収集(NSURLSessionまたはURLSessionを使用する場合) NSURLSessionまたはURLSessionでネットワークを通信する場合、一部の状況でネットワーク収集のための設定が必要です。 * **Objective-C設定方法** ```swift NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration ephemeralSessionConfiguration]; // or default configuration.protocolClasses = [[IMQAMpm sharedInstance] imqaURLSessionProtocol]; NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration]; ``` * **Swift設定方法** ```objectivec let configuration = URLSessionConfiguration.ephemeral // or default configuration.protocolClasses = IMQAMpm.sharedInstance.imqaURLSessionProtocol() let session = URLSession.init(configuration: configuration) ``` ## 4. dSYM設定 iOSのSymbolication（シンボル化）を適用したアプリの場合は、dSYM設定でクラス名と関数名を確認できます。 「IMQA MPMユーザーガイド> 2.4。 プロジェクト管理> dSYM設定」を参照してください。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.imqa.io/imqa-guide/jpn/installation/ios/mpm-sdk-she-ding.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.