Outras APIs tvOS
Importante
O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.
Você pode controlar a quantidade de mensagens de log que aparecem do App Center no console. Use a setLogLevel:
-API para habilitar o log adicional durante a depuração. Por padrão, ele é definido LogLevelAssert
como para o ambiente de App Store eLogLevelWarning
, caso contrário, .
Para ter o máximo possível de mensagens de log, use MSACLogLevelVerbose
/LogLevel.verbose
.
[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.logLevel = .verbose
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.
NSUUID *installId = [MSACAppCenter installId];
var installId = AppCenter.installId
O SDK do App Center dá suporte à configuração de uma ID de usuário usada para aumentar os relatórios de falhas. Para usar essa funcionalidade:
- Configure o SDK do App Center chamando
:start:withServices:
conforme descrito no Guia de introdução do SDK do App Center. - Defina um
userID
no SDK usando o seguinte código:
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "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.
Observação
O valor da ID de usuário é limitado a 256 caracteres. Ele será mostrado com seus relatórios de falha, mas não usado para agregação ou contagens de usuários afetados. Caso você defina a ID de usuário várias vezes, somente a última ID de usuário será usada. Você precisa definir a ID de usuário por conta própria antes da inicialização de cada aplicativo, pois esse valor não é armazenado pelo SDK entre as inicializações.
Se você quiser desabilitar todos os serviços do App Center de uma só vez, use a setEnabled
API . Quando desabilitado, 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 um parâmetro.
[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true
O estado é persistido no armazenamento do dispositivo entre as inicializações do aplicativo.
Observação
Esse método só deve ser usado depois AppCenter
de ter sido iniciado.
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, poderá não permitir o envio automático de dados.
[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false
Nesse caso, o SDK do App Center continua coletando dados, mas ele será enviado somente quando as solicitações de rede forem permitidas.
[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = true
Observação
Esse valor é retido entre as inicializações.
A qualquer momento, você pode marcar se o envio de dados no SDK do App Center é permitido ou não.
[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed
Habilite ou desabilite os serviços no runtime com o seguinte código:
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
Observação
Esse método só deve ser usado depois Analytics
de ter sido iniciado.
Você também poderá marcar se o App Center estiver habilitado ou não.
[MSACAppCenter isEnabled];
AppCenter.enabled
Observação
Esse método só deve ser usado depois AppCenter
de ter sido iniciado, ele sempre retornará false
antes de iniciar.
Você pode obter a versão do SDK do App Center que está usando no momento.
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
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. Também é útil em conjunto com as pause
APIs e resume
. Se você espera ficar em pausa por um longo tempo, poderá usar um tamanho de banco de dados maior para armazenar mais eventos.
Use a setMaxStorageSize
API para definir o tamanho do BD local. A API é assíncrona e a completionHandler
é chamada quando você inicia os serviços do App Center. Por esse motivo, setMaxStorageSize
deve ser chamado antes da 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 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 é de 20 KB.
Observação
O tamanho máximo real do armazenamento pode ser ligeiramente maior do que o valor escolhido. O SQLite arredonda o tamanho para cima até o próximo múltiplo do tamanho da página. O SDK do App Center usa um tamanho de página de 4 KB.
Observação
Os logs com mais de 25 dias serão descartados.
Há muitos motivos pelos quais a completionHandler
chamada pode retornar false.
- O tamanho especificado é um valor inválido (menor que 20 KB ou maior que 140 TB).
- O tamanho atual do banco de dados é maior 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
ouAppCenter.configure
.
Você pode marcar avisos e erros no console usando a marca de AppCenter
log para solucionar problemas de configuração.