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.
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
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
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:
- 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. - 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á.
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í.
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
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í.
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.
Můžete získat verzi sady App Center SDK, kterou aktuálně používáte.
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
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í.
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
neboAppCenter.configure
.
Při řešení potíží s konfigurací můžete zkontrolovat upozornění a chyby v konzole pomocí AppCenter
značky protokolu.