Solução de problemas do SDK do Cordova

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 a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Falha ao instalar o plug-in – falha no comando pod com o código de saída 1

Depois de atualizar para a versão mais recente do plug-in, é provável que você veja a seguinte mensagem de erro durante cordova plugin add cordova-plugin-appcenter-<module>:

Installing "cordova-plugin-appcenter-shared" for ios
Failed to install 'cordova-plugin-appcenter-shared': Error: pod: Command failed with exit code 1

No 0.3.0, deixamos cair o suporte ao iOS 8. O problema com isso é que a 4.5.5 versão do cordova-ios iOS 9.0 de destino por padrão, mas usada iOS 8.0 no podfile. O problema foi corrigido com cordova-ios 5.0.0.

Há duas opções:

  1. cordova platform add ios@5.0.0
  2. Se você quiser ficar em uma versão mais antiga do cordova, vá para platforms>ios, abra Podfile e altere platform :ios, '8.0' para .platform :ios, '9.0' Em seguida, execute pod install.

Falha ao instalar 'cordova-plugin-appcenter-shared': indefinido

Uma possível causa desse erro é ao executar cordova plugin add cordova-plugin-appcenter-<module> sem CocoaPods instalado.

Nesse caso, o erro geralmente inclui esta linha:

Error: CocoaPods was not found. Please install version 1.0.1 or greater from https://cocoapods.org/

Se você vir essa linha, execute:

sudo gem install cocoapods
pod setup

O CocoaPods não pôde encontrar versões compatíveis para o pod "AppCenter"

Se você vir a seguinte mensagem de erro durante cordova plugin add cordova-plugin-appcenter-<module>, as chances são de que o clone local (~/.cocoapods/repos no sistema) do repositório de especificações CocoaPods não esteja atualizado.

CocoaPods could not find compatible versions for pod "AppCenter":
 In Podfile:
   AppCenter (~> 1.12.0)

Execute pod repo update para atualizar o repositório de especificações e tente adicionar o plug-in novamente. Para obter mais informações sobre os comandos CocoaPods, consulte a referência da linha de comando CocoaPods.

Erro de build do iOS não encontrado no módulo 'AppCenter'

Se você vir a seguinte mensagem de erro durante cordova build ios, isso significa que algo deu errado com a instalação do CocoaPods :

.../cordova-plugin-appcenter-shared/AppCenterShared.h:3:9: fatal error: module 'AppCenter' not found
@import AppCenter;
~~~~~~~^~~~~~~~~
1 error generated.

Uma causa possível é que o clone local (~/.cocoapods/repos em seu computador) do repositório de especificações CocoaPods não está atualizado.

Execute pod repo update para atualizar o repositório de especificações e tente adicionar o plug-in novamente. Para obter mais informações sobre os comandos CocoaPods, consulte a referência da linha de comando CocoaPods.

Arquivo morto não encontrado no caminho do erro de build do iOS

Se você vir a seguinte mensagem de erro durante cordova build ios, deverá alternar para o sistema de build herdado.

error: archive not found at path '.../platforms/ios/MyApp.xcarchive'
** EXPORT FAILED **

Para resolve esse problema, especifique --buildFlag="-UseModernBuildSystem=0" ao executar o build. A solução também é descrita neste thread StackOverflow.

Não foi possível localizar o método google() para argumentos [] no erro de build do Android do contêiner de repositório

Se você vir a mensagem de erro a seguir durante cordova build android, as chances são de que sua cordova-android versão seja muito baixa.

FAILURE: Build failed with an exception.

* Where:
Script '.../cordova/platforms/android/cordova-plugin-appcenter-*/*.gradle' line: 3

* What went wrong:
A problem occurred evaluating script.
> Could not find method google() for arguments [] on repository container.

Atualize cordova-android para pelo menos 6.4.0. Você pode executar cordova platform update android para atualizar a plataforma para a versão mais recente ou cordova platform add android@6.4.0 para usar a versão exata.

Análise não aparecendo no portal

Verifique se você adicionou essa linha ao arquivo de configuração:

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

Por padrão, esse valor é false.

Proteger o valor do segredo do App Center

O app_secret é um identificador do seu aplicativo, é necessário saber a qual aplicativo o tráfego se aplica e não pode ser usado para recuperar ou editar dados existentes. Se você app_secret estiver exposto, o maior risco será enviar dados inválidos para seu aplicativo, mas isso não terá efeito sobre a segurança dos dados.

Para recuperar dados confidenciais, você precisaria fornecer um token de aplicativo/usuário, que é gerado no lado do cliente. Não há como tornar os dados do lado do cliente completamente seguros.

Você pode melhorar a segurança do aplicativo usando uma variável de ambiente para injetar o segredo do aplicativo em seu código. Dessa forma, o segredo não está visível em seu código.