Mobile Platform as a Service:SDK の使用

iOS クライアントの問題を診断するには、次の手順を実行します。

1. 診断サービスを初期化する

2. ユーザー ID を設定する

3. 診断ログを書き込む

4. ローカル診断ログを表示する

5. オンラインユーザー診断ログを取得する

診断サービスを初期化する

診断機能を使用する前に、まず初期化してください。

#import <MPDiagnosis/MPDiagnoseAdapter.h>
[MPDiagnoseAdapter initDiagnose];

診断サービスは、同期または プッシュ メソッドによるログのプルをサポートしています。診断サービスを初期化するコードは、ログプルメソッドによって異なります。

モバイル同期サービス（同期）を使用する

同期メソッドを使用して診断ログをプルする場合は、診断機能を使用する前にサービスを初期化する必要があります。

#import <MPDiagnosis/MPDiagnoseAdapter.h>
[MPDiagnoseAdapter initDiagnose];

メッセージプッシュサービス（プッシュ）を使用する

メッセージプッシュサービスを統合し、iOS を最初に完了する必要があります。プッシュされたメッセージを受信した後、次のメソッドを呼び出します。

#import <APLog/APLogMgr.h>
[[APLogMgr sharedInstance] handlePushDiagnosisCmd:[notification.userInfo objectForKey:@"content"]];

アップグレードの注意事項

バージョン 10.1.32 以降、Category ファイルは APLogUser クラスに追加する必要がなくなりました。ミドル層はパッケージングを実装します。アップグレード後、プロジェクト内の以前のバージョンの構成を確認し、存在する場合は削除してください。次に、新しいバージョンから削除する必要がある構成を示します。

ユーザー ID を設定する

診断サービスは、ユーザー ID に基づいてログを抽出します。

1. MPaaSInterface の実装中に、userId 関数を使用してユーザー ID を設定します。

   

2. ユーザー切り替え時、つまり MPaaSInterface の userId 関数で設定された値が変更された場合は、次の関数を呼び出します。

    [MPDiagnoseAdapter userChange];

   詳細については、「MPDiagnoseAdapter.h ファイル (MPDiagnosis 内)」をご参照ください。

診断ログを書き込む

アプリの重要なリンクに診断ログを書き込むには、次のメソッドを呼び出します。

/**
 * kAPLogLevelInfo レベルのメッセージをログに記録します。
 *
 * @param message   ログメッセージと引数のプレースホルダーを含む printf スタイルの文字列を含む NSString オブジェクト。
 * @param ...      フォーマット文字列に表示される引数。
 */
#define APLogInfo(tag,fmt, ...) \
APLogToFile(tag, kAPLogLevelInfo, fmt, ##__VA_ARGS__)

詳細については、「APLog.h ファイル ( APLog 内)」をご参照ください。

たとえば、起動後に診断ログを書き込むには、次の文を呼び出します。

APLogInfo(@"mPaaS", @"Start Cost %d", time);

ローカル診断ログを表示する

次の図に示すように、サンドボックスディレクトリに診断ログがあります。このタイプのログは、デフォルトでは報告されません。コンソールは、必要に応じてログを抽出するコマンドを送信します。

クライアントにローカルに保存される診断ログは、保存期間とファイルサイズによって制限されます。クライアントの診断 SDK は、アプリがバックエンドで実行されている場合、またはプロセスが終了した場合に、次のポリシーに従います。

• 保存期間：デフォルトでは 6 日間。SDK が過去 3 日間のログファイルが 30 MB を超えていることを検出した場合、過去 3 日間のログはすべて削除されます。

• ファイルサイズ：デフォルトでは 100 MB まで。ファイルサイズが 100 MB を超えると、半分のサイズの古いログが削除されます。たとえば、ファイルサイズが 120 MB の場合、60 MB のログが削除されます。

オンラインユーザー診断ログを取得する

アプリがリリースされてオンラインになった後、トラブルシューティングのためにクライアントのローカル診断ログを取得する必要がある場合は、mPaaS コンソールでコマンドを送信して関連する診断ログを取得できます。詳細な操作については、「モバイル分析 > ログの抽出」をご参照ください。