Mobile Platform as a Service:Integrar o mPaaS a um projeto existente com CocoaPods

Use o plugin nativo do CocoaPods para gerar configurações e integrar rapidamente o mPaaS ao seu projeto existente.

Pré-requisitos

• O CocoaPods 1.0.0 ou posterior está instalado e seu projeto é um projeto CocoaPods.

• O plugin cocoapods-mPaaS está instalado. Para instalá-lo, execute:

  sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

• Um aplicativo foi criado no console e o arquivo .config foi baixado. Criar um aplicativo no console.

Procedimento

1. Copie o arquivo de configuração .config para o diretório raiz do projeto, no mesmo nível do Podfile.

   Nota

   O nome do arquivo .config baixado deve terminar com iOS. Renomeie ios para iOS se necessário.

2. Execute pod mpaas init para adicionar as configurações de plugin, source e mPaaS_baseline ao Podfile:

    plugin "cocoapods-mPaaS"
    source 'https://gitee.com/mpaas/podspecs.git'
    mPaaS_baseline 'x.x.x'

3. Configure o Podfile.

   1. Defina a versão da baseline em mPaaS_baseline. Exemplo: mPaaS_baseline '10.2.3', em que 10.2.3 é a versão. Consulte as notas de lançamento para verificar as diferenças entre versões.

   2. Adicione dependências de componentes com mPaaS_pod. Exemplo: mPaaS_pod "mPaaS_Nebula", em que mPaaS_Nebula é o nome de um componente. Componentes disponíveis:

      Configuração do componente	Baseline aplicável	Descrição
      mPaaS_pod "mPaaS_LocalLog"	10.1.32+	Log local
      mPaaS_pod "mPaaS_Log"	10.1.32+	Análise móvel: analisa logs comportamentais, automatizados, de falhas e de desempenho.
      mPaaS_pod "mPaaS_Diagnosis"	10.1.32+	Diagnóstico: fornece diagnósticos no lado do cliente.
      mPaaS_pod "mPaaS_RPC"	10.1.32+	Gateway móvel: oferece downloads, uploads e chamadas RPC.
      mPaaS_pod "mPaaS_Sync"	10.1.32+	Sincronização móvel: disponibiliza um serviço de conexão persistente.
      mPaaS_pod "mPaaS_Push"	10.1.32+	Envio de mensagens push
      mPaaS_pod "mPaaS_Config"	10.1.32+	Configuração remota: busca valores no servidor por chave para controlar a lógica do cliente.
      mPaaS_pod "mPaaS_Upgrade"	10.1.32+	Atualização de aplicativo: verificações de atualização, lançamentos graduais e notificações de versão.
      mPaaS_pod "mPaaS_Share"	10.1.32+	Compartilhamento: permite compartilhar textos e imagens em canais populares como Weibo, DingTalk e Alipay.
      mPaaS_pod "mPaaS_Nebula"	10.1.32+	Contêiner H5 e pacote offline: contêiner Nebula para interação entre código front-end e nativo.
      mPaaS_pod "mPaaS_UTDID"	10.1.32+	ID do dispositivo: recupera um ID de dispositivo único e seguro.
      mPaaS_pod "mPaaS_DataCenter"	10.1.32+	Armazenamento unificado: armazenamento chave-valor (KV) seguro, rápido e criptografável, com múltiplas opções de persistência, incluindo DAO de banco de dados.
      mPaaS_pod "mPaaS_ScanCode"	10.1.32+	Leitura de códigos: reconhece QR codes e códigos de barras.
      mPaaS_pod "mPaaS_LBS"	10.1.32+	Localização móvel: fornece serviços de localização para clientes móveis.
      mPaaS_pod "mPaaS_CommonUI"	10.1.32+	UI comum: disponibiliza uma biblioteca de componentes de UI reutilizáveis.
      mPaaS_pod "mPaaS_Multimedia"	10.1.32+	Multimídia: gerencia downloads, uploads e cache de imagens.
      mPaaS_pod "mPaaS_MobileFramework"	10.1.32+	Mobile Framework: gerencia subaplicativos, aplicativos baseados em abas, navegação de terceiros, transições de controladores de visualização e tratamento de exceções.
      mPaaS_pod "mPaaS_OpenSSL"	10.1.32+	OpenSSL
      mPaaS_pod "mPaaS_TinyApp"	10.1.32+	Mini programa: permite integrar e publicar mini programas.
      mPaaS_pod "mPaaS_CDP"	10.1.32+	Content Delivery Platform: entrega anúncios de marketing e formatos de exibição ao cliente.
      mPaaS_pod "mPaaS_ARTVC"	10.1.68	Chamada de áudio e vídeo: suporta chamadas de vídeo individuais, multiparte e reuniões online.
      mPaaS_pod "mPaaS_BlueShield"	10.2.3+	Componente de Criptografia Blue Shield: gera uma imagem de proteção quando o parâmetro absBase64Code é adicionado ao arquivo de configuração.
      mPaaS_pod "mPaaS_MDC"	10.2.3+	Componente de despacho móvel: despacho de políticas de nome de domínio com granularidade fina.

      Veja abaixo um exemplo completo de Podfile:

      

4. Execute pod mpaas update x.x.x, em que x.x.x é a versão da baseline configurada, como 10.2.3.

5. Execute pod install para concluir a integração. Acrescente --verbose para obter logs detalhados.

   Nota

   Se pod install falhar porque uma biblioteca do GitHub não foi encontrada, adicione source 'https://github.com/CocoaPods/Specs.git' no início do Podfile.

6. Em caso de conflitos com bibliotecas de terceiros, siga as instruções em Resolver conflitos no iOS.

Guia de atualização

É possível atualizar componentes individuais ou toda a baseline (versão do SDK).

Atualizar componentes

1. Execute pod mpaas update x.x.x, em que x.x.x é sua versão atual da baseline, como 10.2.3.

   

2. Execute pod install para atualizar os componentes dessa baseline.

Atualizar a baseline

1. No Podfile, altere a versão da baseline na entrada mPaaS_baseline. Baselines padrão e personalizadas são suportadas. Por exemplo, alterar de 10.1.68 para 10.2.3 atualiza toda a baseline.

   

2. Execute pod install para concluir a atualização da baseline.

Alternar a origem do podspec do mPaaS

Contexto

O repositório code.aliyun.com, que anteriormente hospedava os podspecs do mPaaS, foi desativado. Ele deixou de receber atualizações em 1º de junho de 2023 e o serviço foi encerrado em 30 de junho de 2023.

O uso do repositório antigo causa os seguintes problemas:

1. Impossibilidade de baixar as versões mais recentes do SDK para qualquer baseline.

2. Falha ao baixar qualquer versão da baseline após 30 de junho de 2023.

Todas as versões do mPaaS estão agora disponíveis em gitee.com.

Solução

Atualizar o plugin pod do mPaaS

Atualize o plugin pod do mPaaS:

sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

Após a conclusão do comando, execute pod plugins installed para verificar se a versão do cocoapods-mPaaS é 0.9.6 ou posterior.

Modificar a origem no Podfile

Substitua a source "https://code.aliyun.com/mpaas-public/podspecs.git" original no Podfile pela seguinte:

source "https://gitee.com/mpaas/podspecs.git".

Alterações na API

Apenas o plugin sofre alterações. Os comandos permanecem os mesmos.

Testar e verificar

Após atualizar e configurar, execute os comandos do plugin pod do mPaaS para confirmar que é possível baixar a baseline e o SDK mais recentes.

Lista de parâmetros

Configure parâmetros para personalizar os comportamentos padrão do plugin.

Uso:

Adicione parâmetros após plugin "cocoapods-mPaaS" no Podfile. Exemplo:

Lista de comandos

O plugin cocoapods-mPaaS fornece os seguintes comandos.