その他の macOS 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 が有効になっているかどうかを確認する
App Center が有効になっているかどうかをチェックすることもできます。
[MSACAppCenter isEnabled];
AppCenter.enabled
注意
このメソッドは、開始後 AppCenter にのみ使用する必要があり、常に開始前に戻ります false 。
実行時に App Center SDK のバージョンを確認する
現在使用している App Center SDK のバージョンを取得できます。
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
ストレージ サイズ
App Center SDK を使用する場合、ログはデバイスにローカルに格納されます。 大きなログには多くの領域が必要になるため、ローカル データベースのサイズを制限することもできます。 また、 および API と組み合わせてpauseresume使用すると便利です。 長時間一時停止することが予想される場合は、より大きなデータベース サイズを使用して、より多くのイベントを格納できます。
API を setMaxStorageSize 使用して、ローカル DB のサイズを設定します。 API は非同期であり completionHandler 、App Center サービスを開始すると が呼び出されます。 このため、 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 日より前のログは破棄されます。
失敗した API 呼び出し
呼び出しで false が completionHandler 返される理由は多数あります。
- 指定したサイズが無効な値です (20 KB 未満または 140 TB を超えています)。
- 現在のデータベース サイズが、指定した最大サイズを超えています。
- API は既に呼び出されています。 プロセスごとに 1 回だけ構成できます。
- または の後
AppCenter.startAppCenter.configureに API が呼び出されました。
ログ タグを使用して、コンソールで警告とエラーをチェックして、構成のAppCenter問題をトラブルシューティングできます。