その他の iOS API
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
コンソールで App Center から表示されるログ メッセージの量を制御できます。 デバッグ中に追加の setLogLevel:
ログ記録を有効にするには、-API を使用します。 既定では、App Store環境では に設定され、LogLevelWarning
それ以外の場合は にLogLevelAssert
設定されます。
ログ メッセージをできるだけ多く表示するには、 を使用します MSACLogLevelVerbose
/LogLevel.verbose
。
[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.logLevel = .verbose
アプリがインストールされると、App Center SDK によって各デバイスの UUID が作成されます。 アプリが更新され、アプリが再インストールされたときにのみ新しい識別子が生成される場合、この識別子はデバイスに対して同じままです。 次の API は、デバッグの目的で役立ちます。
NSUUID *installId = [MSACAppCenter installId];
var installId = AppCenter.installId
App Center SDK では、クラッシュ レポートの拡張に使用される ユーザー ID の 設定がサポートされています。 この機能を使用するには:
- App Center SDK の概要ガイドの説明に従って、 を呼び出
:start:withServices:
して App Center SDK を構成します。 - 次の
userID
コードを使用して、SDK で を設定します。
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "your-user-id"
ユーザー ID を設定した後、App Center の検索機能を使用して、ID の特定のクラッシュ レポートを検索できます。 詳細については、App Center の 検索ドキュメントを参照してください。
注意
ユーザー ID の値は 256 文字に制限されています。 クラッシュ レポートと共に表示されますが、影響を受けるユーザーの集計や数には使用されません。 ユーザー ID を複数回設定した場合は、最後のユーザー ID のみが使用されます。 この値は起動の間に SDK によって格納されないため、各アプリケーションの起動前にユーザー ID を自分で設定する必要があります。
すべての App Center サービスを一度に無効にする場合は、API を使用します setEnabled
。 無効にすると、SDK は App Center に情報を転送しません。
[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false
すべてのサービスを再度有効にするには、同じ API を使用しますが、 パラメーターとして を渡します YES
/true
。
[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true
状態は、アプリケーションの起動間でデバイスのストレージに保持されます。
注意
このメソッドは、開始後 AppCenter
にのみ使用する必要があります。
App Center SDK では、ネットワーク要求は既定で許可されます。 ユーザーの懸念事項によって App Center SDK によって収集されたデータを送信する場合は、データの自動送信を禁止できます。
[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false
この場合、App Center SDK は引き続きデータを収集しますが、ネットワーク要求が許可される場合にのみ送信されます。
[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = true
注意
この値は、開始の間に保持されます。
App Center SDK でのデータの送信が許可されているかどうかをいつでもチェックできます。
[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed
次のコードを使用して、ランタイムでサービスを有効または無効にします。
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
注意
このメソッドは、開始後 Analytics
にのみ使用する必要があります。
App Center が有効になっているかどうかをチェックすることもできます。
[MSACAppCenter isEnabled];
AppCenter.enabled
注意
このメソッドは、開始後 AppCenter
にのみ使用する必要があります。常に開始前にが返 false
されます。
現在使用している App Center SDK のバージョンを取得できます。
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
App Center SDK を使用すると、ログはデバイスにローカルに格納されます。 大きなログには多くの領域が必要になるため、ローカル データベースのサイズを制限することもできます。 また、 API と resume
API を組み合わせてpause
使用することもできます。 長時間一時停止することが予想される場合は、より大きなデータベース サイズを使用して、より多くのイベントを格納できます。
API を setMaxStorageSize
使用して、ローカル DB のサイズを設定します。 API は非同期であり、App Center サービスを開始すると が completionHandler
呼び出されます。 このため、 setMaxStorageSize
を 呼び出す前に を呼び出す AppCenter.start
必要があります。 API の呼び出しは 1 回のみ可能です。
// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
if (!success) {
// The success parameter is false when the size can't be honored.
}
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];
// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
if !success {
// The success parameter is false when the size can't be honored.
}
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])
最大ストレージ サイズを設定しない場合、SDK では既定の最大サイズ 10 MB が使用されます。 設定できる最小サイズは 20 KB です。
注意
実際の最大ストレージ サイズは、選択した値よりもわずかに大きくなる可能性があります。 SQLite は、サイズをページ サイズの次の倍数に丸めます。 App Center SDK では、4 KB のページ サイズが使用されます。
注意
25 日より前のログは破棄されます。
呼び出しで false が completionHandler
返される理由は多数あります。
- 指定したサイズが無効な値です (20 KB 未満または 140 TB を超えています)。
- 現在のデータベース サイズが、指定した最大サイズを超えています。
- API は既に呼び出されています。 プロセスごとに 1 回だけ構成できます。
- または の後に
AppCenter.start
AppCenter.configure
API が呼び出されました。
ログ タグを使用して、コンソールで警告とエラーをチェックして、構成のAppCenter
問題をトラブルシューティングできます。