Andere Android-API's

Het logboekniveau aanpassen

U kunt de hoeveelheid logboekberichten beheren door App Center die worden weergegeven in LogCat. Gebruik de AppCenter.setLogLevel() API om extra logboekregistratie in te schakelen tijdens foutopsporing. De logboekniveaus komen overeen met de niveaus die zijn gedefinieerd in android.util.Log. Deze is standaard ingesteld ASSERT op niet-foutopsporingsbare toepassingen en WARN voor foutopsporingsbare toepassingen. U kunt het logboekniveau op elk gewenst moment instellen.

Als u zoveel mogelijk logboekberichten wilt hebben, gebruikt u Log.Verbose.

AppCenter.setLogLevel(Log.VERBOSE);

AppCenter.setLogLevel(Log.VERBOSE)

Installaties identificeren

De App Center SDK maakt een UUID voor elk apparaat zodra de app is geïnstalleerd. Deze id blijft hetzelfde voor een apparaat wanneer de app wordt bijgewerkt en er alleen een nieuwe wordt gegenereerd wanneer de app opnieuw wordt geïnstalleerd of de gebruiker alle app-gegevens handmatig verwijdert. De volgende API is handig voor foutopsporingsdoeleinden.

AppCenter.getInstallId();

AppCenter.getInstallId()

Deze API is asynchroon. In onze Handleiding voor Asynchrone API's van App Center vindt u hier meer informatie over.

Gebruikers identificeren

De App Center SDK ondersteunt het instellen van een gebruikers-id die wordt gebruikt om crashrapporten te verbeteren. Ga als volgt te werk om deze mogelijkheid te gebruiken:

1. Configureer de App Center SDK door aan te roepen AppCenter.start(...) zoals beschreven in de handleiding Aan de slag met de App Center SDK.
2. Stel een userID in de SDK in met behulp van de volgende code:

AppCenter.setUserId("your-user-id");

AppCenter.setUserId("your-user-id")

Nadat u een gebruikers-id hebt ingesteld, kunt u de zoekfunctie van App Center gebruiken om te zoeken naar specifieke crashrapporten voor de id. Meer informatie vindt u in de zoekdocumentatie van App Center.

Alle services tijdens runtime uitschakelen

Als u alle App Center-services tegelijk wilt uitschakelen, gebruikt u de setEnabled() API. Wanneer deze functie is uitgeschakeld, stuurt de SDK geen informatie door naar App Center.

AppCenter.setEnabled(false);

AppCenter.setEnabled(false)

Als u alle services opnieuw wilt inschakelen, gebruikt u dezelfde API, maar geeft u true deze door als een parameter.

AppCenter.setEnabled(true);

AppCenter.setEnabled(true)

De status blijft behouden in de opslag van het apparaat tijdens het starten van de toepassing.

Deze API is asynchroon. In onze Handleiding voor Asynchrone API's van App Center vindt u hier meer informatie over.

Netwerkaanvragen weigeren

In de App Center SDK zijn netwerkaanvragen standaard toegestaan. Als u gegevens wilt verzenden die door de App Center SDK worden verzameld met betrekking tot de gebruiker, kunt u het automatische verzenden van gegevens uitschakelen.

AppCenter.setNetworkRequestsAllowed(false);

AppCenter.setNetworkRequestsAllowed(false)

In dit geval blijft de App Center SDK gegevens verzamelen, maar deze worden alleen verzonden wanneer de netwerkaanvragen zijn toegestaan.

AppCenter.setNetworkRequestsAllowed(true);

AppCenter.setNetworkRequestsAllowed(true)

U kunt op elk gewenst moment controleren of het verzenden van gegevens in de App Center SDK al dan niet is toegestaan.

AppCenter.isNetworkRequestsAllowed();

AppCenter.isNetworkRequestsAllowed()

Status van service wijzigen in runtime

Schakel de services tijdens de runtime in of uit met de volgende code:

Analytics.setEnabled(false);

Analytics.setEnabled(false)

Controleren of App Center is ingeschakeld

U kunt ook controleren of App Center is ingeschakeld of niet.

AppCenter.isEnabled();

AppCenter.isEnabled()

Deze API is asynchroon. In onze Handleiding voor Asynchrone API's van App Center vindt u hier meer informatie over.

Controleer de App Center SDK-versie tijdens uitvoering.

U kunt de versie van de App Center SDK ophalen die u momenteel gebruikt.

AppCenter.getSdkVersion();

AppCenter.getSdkVersion()

Opslaggrootte

Wanneer u de App Center SDK gebruikt, worden logboeken lokaal op het apparaat opgeslagen. Grote logboeken kunnen veel ruimte in beslag nemen, dus u kunt ervoor kiezen om de grootte van de lokale database te beperken. Het is ook handig in combinatie met de pause en resume API's. Als u verwacht dat deze lange tijd wordt onderbroken, kunt u een grotere database gebruiken om meer gebeurtenissen op te slaan.

U kunt de setMaxStorageSize API gebruiken om de grootte van de lokale database in te stellen. De API is asynchroon en de callback wordt aangeroepen wanneer u App Center-services start. Daarom moet setMaxStorageSize worden aangeroepen voordat u AppCenter.start(...) aanroept. U mag de API slechts één keer aanroepen.

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024L).thenAccept(new AppCenterConsumer<Boolean>() {

    @Override
    public void accept(Boolean success) {
        // The success parameter is false when the size can't be honored.
    }
});
AppCenter.start("{Your App Secret}", Analytics.class);

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024).thenAccept {
    // The success parameter (it) is false when the size can't be honored.
}

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

Als u de maximale opslaggrootte niet instelt, gebruikt de SDK een standaard maximale grootte van 10 MB. De minimale grootte die u mag instellen, is 20 kB.

Distributiewinkels toevoegen

Updates in apps werken standaard voor apps die zijn geïnstalleerd vanuit de gedefinieerde lijst met winkels. Als u uw toepassing wilt distribueren via winkels die niet zijn opgenomen in de vooraf gedefinieerde lijst met winkels, kunt u het benodigde pakketinstallatieprogramma toevoegen met behulp van de onderstaande API voordat App Center wordt gestart:

    Set<String> stores = new HashSet<String>();
    stores.add("com.store1.packageinstaller");
    stores.add("com.store2.packageinstaller");
    Distribute.addStores(stores);

Mislukte API-aanroepen

Er zijn veel redenen waarom de callback kan mislukken.

• De opgegeven grootte is een ongeldige waarde (kleiner dan 20 kB of groter dan 140 TB).
• De huidige databasegrootte is groter dan de opgegeven maximale grootte.
• De API is al aangeroepen. U kunt deze slechts één keer per proces configureren.
• De API is aangeroepen na AppCenter.start(...).

U kunt waarschuwingen en fouten in de console controleren met behulp van de AppCenter logboektag om configuratieproblemen op te lossen.

Asynchrone API's in de Android SDK

Asynchrone API's retourneren een AppCenterFuture object in plaats van het resultaat rechtstreeks te retourneren.

U kunt het toekomstige object aanroepen get() om synchroon te wachten op het resultaat of een callback zoals deze op te geven, waarbij u de respectieve retourtypen invult bij het aanroepen van de API:

AppCenterFuture<{ReturnType}> future = {AnyAsyncApi}();
future.thenAccept(new AppCenterConsumer<{ReturnType}>() {

    @Override
    public void accept({ReturnType} result) {

        // do something with result, this is called back in UI thread.
    }
});

val future = {AnyAsyncApi}()
future.thenAccept(object : AppCenterConsumer<{ReturnType}> {
    override fun accept(t: {ReturnType}?) {
        // do something with result, this is called back in UI thread.
    }
})

Om te voorkomen dat gebruikersinterface-threads worden geblokkeerd, waardoor uw toepassing vertraagt, kunt u thenAccept altijd gebruiken met de callback.

Op een achtergrondthread kunt u {AnyAsyncApi}().get() aanroepen.

Voorbeeld van callback:

AppCenter.isEnabled().thenAccept(new AppCenterConsumer<Boolean>() {

    @Override
    public void accept(Boolean enabled) {
        Log.d("MyApp", "AppCenter.isEnabled=" + enabled);
    }
});

AppCenter.isEnabled().thenAccept { enabled -> 
    Log.d("MyApp", "AppCenter.isEnabled=$enabled")
}

Synchroon voorbeeld:

boolean enabled = AppCenter.isEnabled().get();

val enabled = AppCenter.isEnabled().get()