Generate H5 offline packages - Mobile Platform as a Service: Central de Documentação do Alibaba Cloud

Empacote seus recursos de frontend em um bundle offline H5 e publique-o pela plataforma Mobile Delivery Service (MDS) para entregar atualizações no lado do cliente sem exigir uma nova versão completa do aplicativo.

Um pacote offline H5 é um arquivo assinado que agrupa recursos HTML, CSS, JavaScript e imagens para entrega ao contêiner H5 no cliente. Quando o contêiner solicita um recurso por URL, ele verifica primeiro o pacote offline local. Se a URL corresponder a um recurso empacotado localmente, a cópia local será servida; caso contrário, a solicitação será encaminhada ao servidor remoto. Esse mecanismo de interceptação é transparente para o WebView: o mecanismo de renderização trata o conteúdo da mesma forma, independentemente de sua origem ser o bundle local ou a rede.

A geração de um pacote offline ocorre em duas etapas:

Crie o pacote .zip de frontend
Gerar o pacote .amr online

Crie o pacote .zip de frontend

Dois tipos de pacote estão disponíveis, cada um com sua própria estrutura de diretórios:

Pacote de recursos globais: recursos compartilhados referenciados por vários pacotes padrão (scripts comuns, fontes, imagens).
Pacote de recursos padrão: todos os recursos de frontend de um único service (HTML, CSS, JS, imagens).

Nota

Pacotes de recursos globais e pacotes de recursos padrão não podem coexistir no mesmo pacote offline H5.
O ID do pacote offline (nome do diretório de primeiro nível) deve ser um número de 8 dígitos.

Pacote de recursos globais

Um pacote de recursos globais armazena arquivos comuns compartilhados entre vários services, como uma biblioteca JavaScript compartilhada ou uma folha de estilos comum. Estruture o diretório da seguinte forma:

Diretório de primeiro nível: O ID de 8 dígitos do pacote de recursos globais, por exemplo 77777777.
Diretório de segundo nível: O nome de domínio do servidor que hospeda os recursos.
- Nuvem pública: Use mcube-prod.mpaascloud.com. Qualquer outro domínio desativa o recurso de aceleração de publicação em tempo real.
- Apsara Stack: Use o nome de domínio do servidor mdsweb implantado no seu ambiente Apsara Stack.
Diretório de terceiro nível: appId_workspaceId, por exemplo 53E5279071442_test.
Diretórios abaixo do terceiro nível: Seus arquivos de recursos públicos personalizados. Evite caracteres especiais (qualquer caractere codificado pela função urlencode) em nomes de diretórios, nomes de arquivos e conteúdo dos arquivos.

A URL do recurso resultante segue este padrão:

Nuvem pública: http://domain-name/appID_workspace/resource-file-path
Apsara Stack: http://domain-name/mcube/appID_workspace/resource-file-path

Importante
Em um ambiente Apsara Stack, insira /mcube após o diretório de segundo nível (nome de domínio do servidor) no caminho do arquivo de recurso.

Exemplo:

Em um ambiente Apsara Stack, o diretório de segundo nível corresponde ao nome de domínio do servidor mdsweb. Se o nome de domínio for mdsweb-outer.alipay.net, o caminho para common.js mostrado na figura abaixo será https://mdsweb-outer.alipay.net/mcube/53E5279071442_test/common.js.

Nota

O comprimento do caminho absoluto dos recursos públicos não deve exceder 100 caracteres. Caso contrário, o carregamento no cliente pode falhar ou resultar em uma tela em branco.
O servidor não controla uniformemente a versão dos pacotes de recursos globais. Os usuários podem personalizar as estruturas de diretórios de arquivos após o diretório de terceiro nível para gerenciar versões de arquivos de forma diferenciada, conforme suas necessidades.
Em um ambiente de cloud privada, se o servidor usar HDFS ou AFS como formato de armazenamento de arquivos, ou usar HBase como armazenamento de arquivos e a configuração do bucket não for NOT_NEED_BUCKET, adicione um nível adicional de diretório antes do caminho do diretório de terceiro nível mencionado acima. Esse nome de diretório deve corresponder ao nome do espaço de armazenamento (bucket) configurado no servidor mdsweb.
Ao referenciar recursos globais a partir de um pacote offline padrão, use um caminho absoluto, por exemplo https://mcube-prod.mpaascloud.com/53E5279071442_test/common.js.

Pacote de recursos padrão

Um pacote de recursos padrão contém todos os recursos de frontend de um único service. Estruture o diretório da seguinte forma:

Diretório de primeiro nível: O ID de 8 dígitos do pacote de recursos padrão, por exemplo 20171228.
Diretório de segundo nível e abaixo: Seus arquivos de recursos personalizados. Armazene todos os arquivos de frontend em um único subdiretório, como /www, e defina o arquivo de entrada principal que o pacote offline carrega por padrão, por exemplo /www/index.html.

Compactar o diretório em um arquivo .zip

Após organizar o diretório, compacte toda a pasta (aquela que contém o ID do pacote como diretório de primeiro nível) em um arquivo .zip.

Gerar o pacote .amr online

No console, acesse Real-time Release > Offline Package Management. Faça upload do pacote .zip da etapa anterior para a plataforma de publicação MDS para gerar o pacote .amr. Para obter instruções detalhadas, consulte Crie um pacote offline.

Importante

Ao adicionar uma nova configuração de pacote offline, defina a versão mínima do iOS no escopo do cliente com um valor inferior ao campo Product Version no arquivo info.plist do cliente iOS (veja a figura abaixo). Você pode definir a versão mínima do cliente iOS como 1.0.0.
Os campos Product Version e Bundle versions string, short no arquivo info.plist devem ter valores idênticos. Uma incompatibilidade impede que o pacote offline entre em vigor.