その他の iOS API

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替手段の詳細については、こちらを参照してください。

• Android
• iOS
• MAUI/Xamarin
• UWP
• WPF/WinForms
• React Native
• macOS
• tvOS
• Unity
• Cordova

ログ レベルを調整する

コンソールで 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 の 設定がサポートされています。 この機能を使用するには:

1. App Center SDK の概要ガイドの説明に従って、 を呼び出 :start:withServices: して App Center SDK を構成します。
2. 次の 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 と 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 日より前のログは破棄されます。

失敗した API 呼び出し

呼び出しで false が completionHandler 返される理由は多数あります。

• 指定したサイズが無効な値です (20 KB 未満または 140 TB を超えています)。
• 現在のデータベース サイズが、指定した最大サイズを超えています。
• API は既に呼び出されています。 プロセスごとに 1 回だけ構成できます。
• または の後に AppCenter.startAppCenter.configureAPI が呼び出されました。

ログ タグを使用して、コンソールで警告とエラーをチェックして、構成のAppCenter問題をトラブルシューティングできます。