Andere iOS-APIs

Anpassen der Protokollebene

Sie können die Anzahl der Protokollmeldungen steuern, die über das App Center in der Konsole angezeigt werden. Verwenden Sie die setLogLevel:-API, um zusätzliche Protokollierung beim Debuggen zu aktivieren. Standardmäßig ist sie auf LogLevelAssert für die App Store-Umgebung und LogLevelWarning andernfalls festgelegt.

Um so viele Protokollnachrichten wie möglich zu haben, verwenden Sie MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Identifizieren von Installationen

Das App Center SDK erstellt eine UUID für jedes Gerät, sobald die App installiert ist. Dieser Bezeichner bleibt für ein Gerät identisch, wenn die App aktualisiert wird und eine neue nur generiert wird, wenn die App erneut installiert wird. Die folgende API ist für Debuggingzwecke nützlich.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Identifizieren von Benutzern

Das App Center SDK unterstützt das Festlegen einer Benutzer-ID , die zum Erweitern von Absturzberichten verwendet wird. So verwenden Sie diese Funktion:

1. Konfigurieren Sie das App Center SDK durch Aufrufen :start:withServices: , wie im Handbuch für erste Schritte im App Center SDK beschrieben.
2. Legen Sie ein userID SDK mit dem folgenden Code fest:

[MSACAppCenter setUserId:@"your-user-id"];

AppCenter.userId = "your-user-id"

Nachdem Sie eine Benutzer-ID festgelegt haben, können Sie das Suchfeature von App Center verwenden, um nach bestimmten Absturzberichten für die ID zu suchen. Weitere Informationen finden Sie in der Suchdokumentation von App Center.

Deaktivieren aller Dienste zur Laufzeit

Wenn Sie alle App Center-Dienste gleichzeitig deaktivieren möchten, verwenden Sie die setEnabled API. Wenn dies deaktiviert ist, leitet das SDK keine Informationen an das App Center weiter.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

Um alle Dienste erneut zu aktivieren, verwenden Sie dieselbe API, übergeben YES/true sie aber als Parameter.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

Der Zustand wird im Speicher des Geräts über Anwendungsstarts hinweg beibehalten.

Netzwerkanforderungen nicht zulassen

Im App Center SDK sind Netzwerkanforderungen standardmäßig zulässig. Wenn Sie Daten senden möchten, die das App Center SDK vom Benutzer erfasst, können Sie das automatische Senden von Daten nicht zulassen.

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = false

In diesem Fall sammelt das App Center SDK weiterhin Daten, wird aber nur gesendet, wenn die Netzwerkanforderungen zulässig sind.

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

Sie können jederzeit überprüfen, ob das Senden von Daten im App Center SDK zulässig ist oder nicht.

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Ändern des Dienststatus in der Laufzeit

Aktivieren oder deaktivieren Sie die Dienste zur Laufzeit mit folgendem Code:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Überprüfen, ob App Center aktiviert ist

Sie können auch überprüfen, ob App Center aktiviert ist oder nicht.

[MSACAppCenter isEnabled];

AppCenter.enabled

Überprüfen Sie die App Center SDK-Version zur Laufzeit

Sie können die Version des App Center SDK abrufen, die Sie derzeit verwenden.

[MSACAppCenter sdkVersion];

AppCenter.sdkVersion

Speichergröße

Bei Verwendung des App Center SDK werden Protokolle lokal auf dem Gerät gespeichert. Große Protokolle können viel Platz belegen, daher können Sie die Größe der lokalen Datenbank einschränken. Es ist auch in Verbindung mit den pause UND resume APIs nützlich. Wenn Sie erwarten, dass sie lange angehalten werden, können Sie eine größere Datenbankgröße verwenden, um weitere Ereignisse zu speichern.

Verwenden Sie die setMaxStorageSize API, um die Größe der lokalen DB festzulegen. Die API ist asynchron und completionHandler wird aufgerufen, wenn Sie App Center-Dienste starten. Aus diesem Grund muss setMaxStorageSize vor Ihrem Aufruf von AppCenter.start erfolgen. Sie können die API nur einmal aufrufen.

// 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])

Wenn Sie die maximale Speichergröße nicht festlegen, verwendet das SDK eine standardmäßige maximale Größe von 10 MB. Die Mindestgröße, die Sie festlegen dürfen, beträgt 20 KB.

Erfolglose API-Aufrufe

Es gibt viele Gründe, warum der completionHandler Aufruf "false" zurückgeben kann.

• Die angegebene Größe ist ein ungültiger Wert (kleiner als 20 KB oder größer als 140 TB).
• Die aktuelle Datenbankgröße ist größer als die angegebene maximale Größe.
• Die API wurde bereits aufgerufen. Sie können sie nur einmal pro Prozess konfigurieren.
• Die API wurde nach AppCenter.start oder AppCenter.configure aufgerufen.

Sie können Warnungen und Fehler in der Konsole mithilfe des AppCenter Protokolltags überprüfen, um Konfigurationsprobleme zu beheben.