Andra iOS-API:er

Viktigt!

Visual Studio App Center drogs tillbaka den 31 mars 2025, förutom analys- och diagnostikfunktionerna, som fortsätter att stödjas fram till den 30 juni 2026. Läs mer.

• Android
• Ios
• MAUI/Xamarin
• UWP
• WPF/WinForms
• React Native
• macOS
• tvOS
• Enhet

Justera loggnivån

Du kan styra mängden loggmeddelanden som visas från App Center i konsolen. setLogLevel:Använd -API för att aktivera ytterligare loggning vid felsökning. Som standard är det inställt på LogLevelAssert för App Store-miljön och LogLevelWarning i annat fall.

Om du vill ha så många loggmeddelanden som möjligt använder du MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Identifiera installationer

App Center SDK skapar ett UUID för varje enhet när appen har installerats. Den här identifieraren förblir densamma för en enhet när appen uppdateras och en ny genereras endast när appen installeras på nytt. Följande API är användbart för felsökning.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Identifiera användare

App Center SDK stöder inställning av ett användar-ID som används för att utöka kraschrapporter. Så här använder du den här funktionen:

1. Konfigurera App Center SDK genom att anropa :start:withServices: enligt beskrivningen i guiden Komma igång med App Center SDK.
2. Ange en userID i SDK:en med hjälp av följande kod:

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

AppCenter.userId = "your-user-id"

När du har angett ett användar-ID kan du använda App Centers sökfunktion för att söka efter specifika kraschrapporter för ID:t. Läs mer i App Centers sökdokumentation.

Anmärkning

Värdet för användar-ID:t är begränsat till 256 tecken. Den visas med dina kraschrapporter men används inte för aggregering eller antal berörda användare. Om du anger användar-ID flera gånger används endast det senaste användar-ID:t. Du måste ange användar-ID:t själv innan varje program startas, eftersom det här värdet inte lagras av SDK:t mellan lanseringarna.

Inaktivera alla tjänster vid körning

Om du vill inaktivera alla App Center-tjänster samtidigt använder du API:et setEnabled . När den är inaktiverad vidarebefordrar SDK:t inte någon information till App Center.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

Om du vill aktivera alla tjänster på en gång använder du samma API men skickar YES/true som en parameter.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

Tillståndet sparas i enhetens lagring mellan programstarter.

Anmärkning

Den här metoden får endast användas efter att AppCenter har startats.

Tillåt inte nätverksbegäranden

I App Center SDK tillåts nätverksbegäranden som standard. Om du vill skicka data som App Center SDK samlar in av användaren kan du inte tillåta automatisk sändning av data.

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = false

I det här fallet fortsätter App Center SDK att samla in data, men de skickas endast när nätverksbegäranden tillåts.

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

Anmärkning

Det här värdet behålls mellan starterna.

När som helst kan du kontrollera om det är tillåtet eller inte att skicka data i App Center SDK.

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Ändra tjänsttillstånd under körning

Aktivera eller inaktivera tjänsterna vid körningen med följande kod:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Anmärkning

Den här metoden får endast användas efter att Analytics har startats.

Kontrollera om App Center är aktiverat

Du kan också kontrollera om App Center är aktiverat eller inte.

[MSACAppCenter isEnabled];

AppCenter.enabled

Anmärkning

Den här metoden får endast användas efter att AppCenter har startats; den kommer alltid att returnera false före start.

Kontrollera App Center SDK-versionen vid körning

Du kan hämta den version av App Center SDK som du använder för närvarande.

[MSACAppCenter sdkVersion];

AppCenter.sdkVersion

Lagringsstorlek

När du använder App Center SDK lagras loggar lokalt på enheten. Stora loggar kan ta upp mycket utrymme, så du kan välja att begränsa storleken på den lokala databasen. Det är också användbart tillsammans med API:erna pause och resume . Om du förväntar dig att pausas under en längre tid kan du använda en större databasstorlek för att lagra fler händelser.

Använd API:et setMaxStorageSize för att ange storleken på den lokala databasen. API:et är asynkront och completionHandler anropas när du startar App Center-tjänster. Därför setMaxStorageSize måste anropas innan anropet till AppCenter.start. Du kan bara anropa API:et en gång.

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

Om du inte anger den maximala lagringsstorleken använder SDK:t en maximal standardstorlek på 10 MB. Den minsta storlek som du får ange är 20 kB.

Anmärkning

Den faktiska maximala lagringsstorleken kan vara något högre än det värde du har valt. SQLite rundar upp storleken till nästa multipel av sidstorleken. App Center SDK använder en sidstorlek på 4 KB.

Anmärkning

Loggar som är äldre än 25 dagar tas bort.

Misslyckade API-anrop

Det finns många orsaker till att anropet completionHandler kan returnera falskt.

• Den angivna storleken är ett ogiltigt värde (mindre än 20 KB eller större än 140 TB).
• Den aktuella databasstorleken är större än den angivna maximala storleken.
• API:et har redan anropats. Du kan bara konfigurera den en gång per process.
• API:et har anropats efter AppCenter.start eller AppCenter.configure.

Du kan kontrollera varningar och fel i konsolen med hjälp av AppCenter loggtaggen för att felsöka konfigurationsproblem.