Notas de versão do mPaaS 10.1.68
A partir da baseline 10.1.68, o UIWebView foi descontinuado e apenas o WKWebView tem suporte. Para mais informações, consulte Adaptar o mPaaS ao WKWebView. A App Store deixou de aceitar novos aplicativos que usam UIWebView em abril de 2020 e interromperá a aceitação de atualizações para aplicativos existentes com essa tecnologia em dezembro de 2020. Atualize para a baseline 10.1.68 e adapte seu aplicativo para o WKWebView o quanto antes.
Esta versão permite compilar e empacotar bibliotecas estáticas com o Xcode 11, garantindo compatibilidade durante o desenvolvimento.
Guia de upgrade do mPaaS 10.1.68
Upgrade via mPaaS Xcode Extension
Pré-requisitos
Verifique se a mPaaS Xcode Extension está atualizada para a versão 1.1.0 ou posterior. Para atualizar a extensão, consulte Atualizar a mPaaS Xcode Extension.
Procedimento
-
No menu do Xcode, clique em Editor > mPaaS > Edit Project para abrir a mPaaS Xcode Extension.
Caso já tenha integrado a baseline 10.1.68, selecione a opção Update Product Set para atualizar para o conjunto de produtos mais recente.
Se estiver usando uma baseline diferente da 10.1.68, selecione a opção Upgrade Baseline. Defina a versão da baseline como 10.1.68. O processo pode ser demorado; não feche a janela do plugin durante a execução.
Após a conclusão bem-sucedida da atualização ou upgrade, o plugin exibirá a versão do SDK do projeto como 10.1.68.
Upgrade via CocoaPods
Pré-requisitos
O plugin mPaaS para CocoaPods deve estar instalado.
-
Se ainda não instalou o plugin mPaaS para CocoaPods, execute o script abaixo no terminal para instalá-lo.
sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh) Se já tiver o plugin instalado, execute o comando
pod mpaas update --allpara atualizá-lo. Consulte Integração com framework nativo usando CocoaPods para mais detalhes sobre o uso do plugin.
Procedimento
Altere a versão do SDK para 10.1.68 no Podfile.
Execute
pod mpaas update 10.1.68para instalar o SDK mais recente da baseline 10.1.68.Se necessário, execute
pod installoupod updatepara concluir o upgrade do projeto para a versão 10.1.68.
Próximos passos
Caso ocorra um erro semelhante ao exemplo abaixo durante a integração com CocoaPods:
Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.68 found !!! Check name & version in Podfile.Siga os passos abaixo para resolver o problema:
Verifique a versão do plugin CocoaPods executando o comando
gem list | grep 'mPaaS', conforme ilustrado na figura a seguir.
Se a versão do plugin for anterior à 0.9.5, reinstale-o usando o script abaixo.
sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)Guia de upgrade de componentes
Leia atentamente as instruções abaixo caso sua baseline atual seja anterior à 10.1.60 e você tenha integrado os componentes H5 Container, Mini Program e Hotpatching:
Atenção especial às orientações a seguir se a baseline atual for anterior à 10.1.60 e houver integração dos componentes H5 Container e Mini Program:
Consulte o Guia de upgrade do H5 Container 10.1.60 para detalhes sobre a atualização do H5 Container e pacotes offline.
Veja as Notas de upgrade do Mini Program para informações específicas sobre essa atualização.
Revise as Notas de upgrade do Mini Program para orientações adicionais.
Atualize também a biblioteca de hotpatching para a versão 10.1.68 quando a baseline atual for inferior à 10.1.60. Obtenha essa biblioteca por meio do suporte técnico. Para entrar em contato, participe do grupo DingTalk 145930007362.
Alterações nas APIs dos componentes
Os componentes do mPaaS incluem uma camada de adaptação desde a baseline 10.1.32. Caso sua baseline atual não use as APIs dessa camada, consulte Adaptar o mPaaS 10.1.32 ao iOS 13 antes de prosseguir.
Use as APIs da camada de adaptação após o upgrade do SDK. Confira as notas sobre upgrades a partir de versões anteriores nos documentos dos componentes listados abaixo:
Observe as alterações na configuração da categoria e no arquivo info.plist de cada componente mPaaS no seu projeto.
Modifique seu código para usar os métodos da camada intermediária (adaptador) em vez dos métodos subjacentes. Alguns métodos de baixo nível podem ser alterados ou descontinuados em versões futuras. O uso contínuo deles pode exigir mais tempo de adaptação em atualizações posteriores.
O recurso de hotpatching para iOS destina-se exclusivamente ao Apsara Stack. Entre em contato com o suporte técnico do mPaaS para mais informações.
Tratamento de bibliotecas personalizadas
Os componentes da baseline 10.1.68 incorporam requisitos personalizados. Contudo, se suas dependências incluíam bibliotecas personalizadas e você está migrando de uma versão anterior do SDK, como a 10.1.32, para a 10.1.68, talvez seja necessário personalizar novamente essas bibliotecas para a nova versão. Para consultoria, busque e participe do grupo DingTalk 145930007362.
Componente Share
Os SDKs de terceiros presentes no componente Share da versão 10.1.68 foram atualizados, incluindo WeChat SDK, Weibo SDK e QQ Connect SDK. As versões mais recentes para compartilhamento via WeChat e QQ adicionaram o recurso Universal Link. Adapte seu aplicativo aos novos SDKs seguindo os passos abaixo:
Atualize as informações de configuração do aplicativo na plataforma de terceiros correspondente. Essas informações estão disponíveis na seção de gerenciamento de aplicativos da sua conta de desenvolvedor nessa plataforma. Consulte a documentação fornecida pela plataforma para conhecer os métodos específicos de adaptação.
Para o compartilhamento via WeChat, adicione o campo "universalLink" às informações de configuração do componente Share do mPaaS. Defina o valor desse campo como o endereço Universal Link do seu aplicativo.