Compartilhar via


CodePush

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.

Saiba mais sobre linhas do tempo e alternativas de suporte.

O CodePush é um serviço de nuvem do App Center que permite que React Native desenvolvedores implantem atualizações de aplicativo móvel diretamente nos dispositivos de seus usuários. Ele funciona atuando como um repositório central no qual os desenvolvedores podem publicar determinadas atualizações (por exemplo, JS, HTML, CSS e alterações de imagem), e os aplicativos podem consultar atualizações de (usando os SDKs de cliente fornecidos). Isso permite que você tenha um modelo de envolvimento mais determinístico e direto com seus usuários finais ao resolver bugs, adicionando pequenos recursos que não exigem que você recompile um binário ou redistribua-o por meio de lojas de aplicativos públicos. Todos os aplicativos React Native criados no App Center são habilitados para CodePush por padrão; para começar a usar o CodePush, você precisa das seguintes etapas:

Observação

Para dispositivos Android, o CodePush só funcionará em dispositivos compatíveis com TLS 1.2

Observação

O uso da API CodePush tem uma limitação de taxa de 8 solicitações por 5 minutos aplicadas. Eles são contados por combinação do seguinte: ponto de extremidade solicitado, solicitação de IP proveniente, chave de implantação e ID exclusiva do cliente. Se o limite for atingido, a resposta com um código de status 429 será retornada:

{
   "statusCode": 429,
   "message": "Rate limit is exceeded. Try again in X seconds."
}

1. Instalar a CLI do App Center

Você gerencia a maior parte da funcionalidade do CodePush usando a CLI do App Center. Para instalar a CLI, abra uma janela do terminal ou um prompt de comando e execute o seguinte comando:

npm install -g appcenter-cli

Observação

Se você encontrar um EACCES erro ao executar esse comando, talvez seja necessário corrigir permissões npm em seu sistema. Muitos sites recomendam usar o sudo comando para contornar esse erro, mas você nunca deve instalar módulos npm usando sudo.

Depois de instalar com êxito a CLI do App Center, execute o appcenter login comando para configurar a CLI para os detalhes da conta do App Center.

2. CodePush-ify seu aplicativo

Adicione o SDK do cliente CodePush ao seu aplicativo e configure-o para efetuar pull de atualizações de aplicativos de uma de suas implantações no App Center. As seções a seguir fornecem detalhes sobre como fazer isso para as plataformas de aplicativos com suporte:

3. Liberar uma atualização de aplicativo

Depois de fazer alterações no código ou nos ativos do aplicativo, publique a atualização no App Center usando a CLI do App Center, conforme descrito nas seções a seguir.

React Native

Execute o comando da CLI release-react do App Center para agrupar o código e os arquivos de ativos do aplicativo e publicá-los no servidor do App Center como uma nova versão. Por exemplo:

appcenter codepush release-react -a <ownerName>/MyApp

Cordova

Execute o comando da CLI release-cordova do App Center para agrupar o código e os arquivos de ativos do aplicativo e publicá-los no servidor do App Center como uma nova versão. Por exemplo:

appcenter codepush release-cordova -a <ownerName>/MyApp

Dica

Um recurso importante na CLI do App Center é a capacidade de definir um aplicativo como o aplicativo atual usando appcenter apps set-current <ownerName>/<appName>. Definindo um aplicativo como o aplicativo atual, você não precisa usar o -a sinalizador . Por exemplo, o comando appcenter codepush deployment list -a <ownerName>/<appName> pode ser digitado como appcenter codepush deployment list se o aplicativo atual estivesse definido. Você pode marcar qual aplicativo é definido como o aplicativo atual da sua conta usando appcenter apps get-current. Utilizar esse comando torna a maioria dos comandos da CLI mais curta.

4. Executar seu aplicativo

Depois que essas etapas forem concluídas, todos os usuários que executam seu aplicativo receberão a atualização usando a experiência configurada na etapa 2. Para obter mais informações, consulte a documentação da CLI e do SDK do cliente (Apache Cordova, React Native).