Outras APIs do iOS

Ajustar o nível de log

Você pode controlar a quantidade de mensagens de log que aparecem do App Center no console. Use a API setLogLevel: para habilitar o registo adicional durante a depuração. Por padrão, ele é definido como LogLevelAssert para o ambiente da App Store e LogLevelWarning caso contrário.

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

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Identificar instalações

O SDK do App Center cria um 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.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Identificar usuários

O SDK do App Center suporta a definição de um ID de usuário que é usado para aumentar os relatórios de falhas. Para usar esse recurso:

1. Configure o SDK do App Center chamando :start:withServices: conforme descrito no Guia de introdução do SDK do App Center.
2. Defina um userID no SDK usando o seguinte código:

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

AppCenter.userId = "your-user-id"

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

Desativar todos os serviços em tempo de execução

Se quiser desativar todos os serviços do App Center de uma só vez, use a setEnabled API. Quando desativado, o SDK não encaminhará nenhuma informação para o App Center.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

Para habilitar todos os serviços novamente, use a mesma API, mas passe YES/true como parâmetro.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

O estado é persistido no armazenamento do dispositivo em todas as inicializações de aplicativos.

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 quando solicitado pelo usuário, pode desativar o envio automático de dados.

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = 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.

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

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

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Alterar o estado do serviço em tempo de execução

Habilite ou desabilite os serviços no tempo de execução com o seguinte código:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Verifique se o App Center está ativado

Você também pode verificar se o App Center está habilitado ou não.

[MSACAppCenter isEnabled];

AppCenter.enabled

Verifique a versão do SDK do App Center em tempo de execução

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

[MSACAppCenter sdkVersion];

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, então você pode optar por limitar o tamanho do banco de dados local. Também é útil em conjunto com as APIs pause e resume. Se você espera ser pausado por um longo tempo, você pode usar um tamanho de banco de dados maior para armazenar mais eventos.

Use a setMaxStorageSize API para definir o tamanho do banco de dados local. A API é assíncrona e é chamada quando você inicia os serviços do completionHandler App Center. Por esta razão, setMaxStorageSize deve ser chamado antes da sua chamada para AppCenter.start. Você só pode chamar a API uma vez.

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

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

Chamadas de API malsucedidas

Há muitas razões pelas quais a completionHandler chamada pode retornar falsa.

• O tamanho especificado é um valor inválido (inferior a 20 KB ou superior a 140 TB).
• O tamanho atual do banco de dados é maior do que o tamanho máximo especificado.
• A API já foi chamada. Você pode configurá-lo apenas uma vez por processo.
• A API foi chamada após AppCenter.start ou AppCenter.configure.

Você pode verificar avisos e erros no console usando a AppCenter marca de log para solucionar problemas de configuração.