Crie um pacote offline HTML5 definindo configurações básicas, versões de cliente alvo e comportamento de download — individualmente ou em lote.
Pré-requisitos
Antes de começar, verifique se você:
Configurou as definições do pacote offline HTML5 na página Configuration Management. Para mais detalhes, consulte Configurar um pacote offline.
Como funciona
Dois métodos de criação estão disponíveis:
Pacote único: Configure e envie um único pacote offline pelo formulário do console.
Importação em lote: Envie vários arquivos
.zipsimultaneamente para criar pacotes em massa — ideal para lançar diversos H5Apps ao mesmo tempo.
Ao enviar um pacote para um H5App pela primeira vez, selecione o tipo de pacote de recursos. Essa escolha é definitiva e não pode ser alterada posteriormente, pois cada H5App aceita apenas um tipo de pacote.
Procedimento
Criar um único pacote offline
No painel de navegação à esquerda, escolha Mobile Delivery Service > Offline package management.
Na página Offline Package Management, clique em Create an HTML5 App. Ignore esta etapa caso já tenha criado um H5App.
-
Na janela Create an HTML5 App, insira o HTML5 App ID e o HTML5 App name e clique em OK. Pule este passo se o H5App já existir.
ImportanteO ID do H5App deve conter exatamente 8 dígitos numéricos.
Os IDs
20000196,66666692,68687029e68687209são reservados pelo kit de desenvolvimento de software (SDK). Não os utilize para evitar conflitos.Evite usar IDs de H5App que comecem com
666666ou20000.
Selecione o H5App na lista e clique em Add an offline package à direita.
-
Na seção Basic information, defina os seguintes parâmetros:
-
Resource package type: Selecione Global resource package ou Normal resource package.
NotaCaso utilize um pacote de recursos global, renomeie o diretório de segundo nível dentro do pacote para
mcube-prod.mpaascloud.com. Sem essa alteração, o recurso de aceleração de lançamento em tempo real não funcionará. HTML5 app version: Insira o número da versão do pacote offline — por exemplo,
1.0.0.1.File: Envie o pacote offline no formato
.zip.-
Client version: Escolha a plataforma de cliente alvo (Android, iOS ou ambas) e defina o intervalo de versões. Apenas clientes dentro do intervalo especificado receberão o pacote offline.
NotaÉ obrigatório selecionar pelo menos uma plataforma de cliente. Se optar por Android e iOS simultaneamente, ambas devem seguir a mesma estratégia para a versão máxima: deixe ambos em branco (padrão do sistema) ou defina o mesmo valor para os dois.
Deixe a versão máxima em branco para garantir compatibilidade com todas as futuras versões do cliente. Definir um limite máximo específico pode interromper a entrega caso seu aplicativo seja atualizado além dessa versão.
A versão do cliente iOS deve ser inferior ao valor do campo Product Version no arquivo
info.plistdo projeto.
-
-
Na seção Configuration information, configure os parâmetros abaixo:
-
URL of main entrance: Opcional. URL da página inicial do pacote offline.
NotaInsira o caminho completo — por exemplo,
/www/index.html, onde/wwwcorresponde ao nome do seu diretório de segundo nível. Virtual domain: Preenchido automaticamente com o valor informado durante a configuração do pacote offline.
-
Extended information: Opcional. Adicione parâmetros de carregamento da página como pares chave-valor (KV) separados por vírgulas.
Utilize este campo para definir um intervalo de solicitação por pacote, controlando a frequência com que o cliente verifica atualizações.
Pacote único: Insira
{"asyncReqRate":"1800"}para aplicar um intervalo de solicitação exclusivo a este pacote, onde1800representa o intervalo em segundos. O intervalo válido vai de 0 a 86400 segundos (0 a 24 horas). Definir0remove o limite de intervalo.Global: Defina o intervalo no código do cliente para aplicá-lo a todos os pacotes offline. Para mais informações, consulte Início Rápido e Início rápido.
-
Time for download: Determine quando o cliente baixará o pacote offline.
Wi-Fi only: O download ocorre automaticamente em segundo plano apenas quando o dispositivo estiver conectado a uma rede Wi-Fi.
All networks: Permite o download em qualquer rede, incluindo dados móveis. Use esta opção com cautela, pois ela consome o plano de dados do usuário sem aviso prévio.
-
Time of installation: Escolha o momento da instalação após o download.
Not preload: A instalação acontece somente quando o usuário abre o pacote offline pela primeira vez.
Preload: O pacote é instalado automaticamente assim que o download termina.
-
Marque a caixa de seleção I confirm the above information is accurate e clique em Submit.
Importar pacotes offline em lote
A importação em lote permite criar múltiplos pacotes offline em uma única operação, sendo mais ágil que a criação individual e reduzindo riscos de erros de configuração.
Dois comportamentos ocorrem automaticamente após a importação:
Caso o H5App associado a um pacote importado não exista, o sistema cria um novo H5App automaticamente.
Se o H5App já existir, o sistema adiciona o pacote importado a ele.
No painel de navegação à esquerda, escolha Mobile Delivery Service > Offline package management e clique em Batch import HTML5 app.
-
Na janela Batch import HTML5 app, envie os arquivos de pacote offline (
.zip).NotaO tamanho total do upload não pode exceder 300 MB, e a quantidade de pacotes está limitada a 100.
Nomeie cada arquivo com o ID correspondente de 8 dígitos do pacote offline.
-
Na página de resultados da importação, clique em Edit na coluna Operation de cada pacote para revisar e atualizar suas informações básicas. Para a descrição de cada campo, consulte Criar um único pacote offline.
Os números de versão são atribuídos automaticamente durante a importação:
Se o H5App ainda não existir, a versão padrão será
0.0.0.1.Quando o H5App já existe, a versão assume o próximo incremento após a maior versão existente.
Após editar todos os pacotes, marque a caixa de seleção The information can't be modified after submission e clique em Submit. Se a validação for bem-sucedida, os pacotes aparecerão na página Offline Package Management. Em caso de falha, analise a mensagem de erro e corrija as entradas afetadas.