Outras APIs UWP e WinUI

Ajustar o nível de log

Você pode controlar a quantidade de mensagens de log que aparecem do App Center no console. Use a LogLevel API para habilitar o registro em log adicional durante a depuração. Por padrão, ele é definido ASSERT como para os ambientes de App Store eWARN, caso contrário, .

Para ter o maior número possível de mensagens de log, use LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

Identificar instalações

O SDK do App Center cria uma UUID para cada dispositivo depois que o aplicativo é instalado. Esse identificador permanece o mesmo para um dispositivo quando o aplicativo é atualizado e um novo é gerado somente quando o aplicativo é reinstalado. A API a seguir é útil para fins de depuração.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Identificar usuários

O SDK do App Center dá suporte à configuração de uma ID de usuário usada para aumentar os relatórios de falha. Para usar essa funcionalidade:

1. Configure o SDK do App Center chamando AppCenter.Start(...) conforme descrito no guia de introdução do SDK do App Center.
2. Defina um userID no SDK usando o seguinte código:

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

Depois de definir uma ID de usuário, você pode usar o recurso de pesquisa do App Center para pesquisar relatórios de falha específicos para a ID. Saiba mais na documentação de pesquisa do App Center.

Desabilitar todos os serviços em runtime

Se você quiser desabilitar todos os serviços do App Center de uma só vez, use a Enabled propriedade . Quando desabilitado, o SDK não encaminhará nenhuma informação para o App Center.

AppCenter.SetEnabledAsync(false);

Para habilitar todos os serviços mais uma vez, use a mesma API, mas passe true como um parâmetro.

AppCenter.SetEnabledAsync(true);

Você não precisa aguardar essa chamada para tornar outras chamadas à API (como IsEnabledAsync) consistentes.

O estado é persistente no armazenamento do dispositivo entre as inicializações de aplicativos.

Alterar o estado do serviço em runtime

Habilite ou desabilite os serviços no runtime com o seguinte código:

Analytics.SetEnabledAsync(false);

Não permitir solicitações de rede

No SDK do App Center, as solicitações de rede são permitidas por padrão. Se você quiser enviar dados que o SDK do App Center coleta pela preocupação do usuário, você pode não permitir o envio automático de dados.

AppCenter.IsNetworkRequestsAllowed = false;

Nesse caso, o SDK do App Center continua a coletar dados, mas eles serão enviados somente quando as solicitações de rede forem permitidas.

AppCenter.IsNetworkRequestsAllowed = true;

A qualquer momento, você pode marcar se o envio de dados no SDK do App Center é permitido ou não.

AppCenter.IsNetworkRequestsAllowed;

Verificar se o App Center está habilitado

Você também pode marcar se o App Center estiver habilitado ou não.

bool enabled = await AppCenter.IsEnabledAsync();

Verificar a versão do SDK do App Center no runtime

Você pode obter a versão do SDK do App Center que está usando no momento.

AppCenter.SdkVersion;

Tamanho de armazenamento

Ao usar o SDK do App Center, os logs são armazenados localmente no dispositivo. Logs grandes podem ocupar muito espaço, portanto, você pode optar por limitar o tamanho do banco de dados local.

Você pode usar a SetMaxStorageSizeAsync API para definir o tamanho do BD local. A API é assíncrona e o retorno de chamada é chamado quando você inicia os serviços do App Center. Por esse motivo, SetMaxStorageSizeAsync deve ser chamado antes da chamada para AppCenter.Start(...). Você só pode chamar a API uma vez.

// Use 20 MB for storage.
AppCenter.SetMaxStorageSizeAsync(20 * 1024 * 1024).ContinueWith((storageTask) => {
    // The storageTask.Result is false when the size cannot be honored.
});
AppCenter.Start("{Your App Secret}", typeof(Analytics));

Se você não definir o tamanho máximo do armazenamento, o SDK usará um tamanho máximo padrão de 10 MB. O tamanho mínimo que você tem permissão para definir é 20 KB.