Číst v angličtině

Sdílet prostřednictvím


Další rozhraní API pro tvOS

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

Úprava úrovně protokolu

Můžete řídit množství zpráv protokolu, které se zobrazí z App Center v konzole nástroje . K povolení dalšího setLogLevel:protokolování při ladění použijte -API. Ve výchozím nastavení je pro prostředí App Store nastavená na LogLevelAssert a LogLevelWarning jinak.

Pokud chcete mít co nejvíce zpráv protokolu, použijte MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.logLevel = .verbose

Identifikace instalací

Sada App Center SDK vytvoří UUID pro každé zařízení po instalaci aplikace. Tento identifikátor zůstává stejný pro zařízení při aktualizaci aplikace a nový se vygeneruje jenom při opětovné instalaci aplikace. Následující rozhraní API je užitečné pro účely ladění.

NSUUID *installId = [MSACAppCenter  installId];
var installId = AppCenter.installId

Identifikace uživatelů

Sada App Center SDK podporuje nastavení ID uživatele , které se používá k rozšíření zpráv o chybách. Použití této funkce:

  1. Nakonfigurujte sadu App Center SDK voláním, :start:withServices: jak je popsáno v příručce Začínáme se sadou App Center SDK.
  2. Pomocí userID následujícího kódu nastavte v sadě SDK :
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "your-user-id"

Po nastavení ID uživatele můžete pomocí funkce vyhledávání v App Center vyhledat konkrétní zprávy o chybách pro dané ID. Další informace najdete v dokumentaci k vyhledávání v App Center.

Poznámka

Hodnota ID uživatele je omezená na 256 znaků. Zobrazí se se zprávami o chybách, ale nepoužije se pro agregaci ani počty ovlivněných uživatelů. Pokud nastavíte ID uživatele vícekrát, použije se jenom poslední ID uživatele. ID uživatele musíte nastavit sami před každým spuštěním aplikace, protože tuto hodnotu sada SDK mezi spuštěními neukládá.

Zakázat všechny služby za běhu

Pokud chcete zakázat všechny služby App Center najednou, použijte setEnabled rozhraní API. Pokud je tato možnost zakázaná, sada SDK nepředá do App Center žádné informace.

[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false

Pokud chcete znovu povolit všechny služby najednou, použijte stejné rozhraní API, ale předejte YES/true ho jako parametr.

[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true

Stav se během spouštění aplikací zachová v úložišti zařízení.

Poznámka

Tuto metodu je možné použít až po AppCenter spuštění.

Zakázat síťové požadavky

V sadě App Center SDK jsou síťové požadavky ve výchozím nastavení povolené. Pokud chcete odesílat data, která sada App Center SDK shromažďuje ze strany uživatele, můžete zakázat automatické odesílání dat.

[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false

V tomto případě sada App Center SDK nadále shromažďuje data, ale budou odeslána, pouze pokud budou povoleny síťové požadavky.

[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = true

Poznámka

Tato hodnota se zachová mezi spuštěními.

Kdykoli můžete zkontrolovat, jestli je odesílání dat v sadě App Center SDK povolené nebo ne.

[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed

Změna stavu služby v modulu runtime

Povolte nebo zakažte služby za běhu pomocí následujícího kódu:

[MSACAnalytics setEnabled:NO];
Analytics.enabled = false

Poznámka

Tuto metodu je možné použít až po Analytics spuštění.

Kontrola, jestli je povolená aplikace App Center

Můžete také zkontrolovat, jestli je služba App Center povolená nebo ne.

[MSACAppCenter isEnabled];
AppCenter.enabled

Poznámka

Tato metoda musí být použita pouze po AppCenter spuštění, bude vždy vrácena false před spuštěním.

Kontrola verze sady App Center SDK za běhu

Můžete získat verzi sady App Center SDK, kterou aktuálně používáte.

[MSACAppCenter sdkVersion];
AppCenter.sdkVersion

Velikost úložiště

Při použití sady App Center SDK se protokoly ukládají místně v zařízení. Velké protokoly můžou zabírat hodně místa, takže se můžete rozhodnout omezit velikost místní databáze. Je také užitečné ve spojení s rozhraními pause API a resume . Pokud očekáváte, že bude pozastavený na dlouhou dobu, můžete k ukládání více událostí použít větší velikost databáze.

setMaxStorageSize Pomocí rozhraní API nastavte velikost místní databáze. Rozhraní API je asynchronní a completionHandler při spuštění služeb App Center se volá . Z tohoto důvodu setMaxStorageSize musí být volána před voláním .AppCenter.start Rozhraní API můžete volat pouze jednou.

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

Pokud nenastavíte maximální velikost úložiště, sada SDK použije výchozí maximální velikost 10 MB. Minimální velikost, kterou můžete nastavit, je 20 kB.

Poznámka

Skutečná maximální velikost úložiště může být o něco vyšší než hodnota, kterou jste zvolili. SQLite zaokrouhlí velikost nahoru na další násobek velikosti stránky. Sada App Center SDK používá velikost stránky 4 kB.

Poznámka

Protokoly starší než 25 dnů se zahodí.

Neúspěšná volání rozhraní API

Existuje mnoho důvodů, proč completionHandler může volání vrátit hodnotu false.

  • Zadaná velikost je neplatná hodnota (menší než 20 kB nebo větší než 140 TB).
  • Aktuální velikost databáze je větší než zadaná maximální velikost.
  • Rozhraní API už bylo volána. Můžete ho nakonfigurovat pouze jednou pro každý proces.
  • Rozhraní API bylo volána po AppCenter.start nebo AppCenter.configure.

Při řešení potíží s konfigurací můžete zkontrolovat upozornění a chyby v konzole pomocí AppCenter značky protokolu.