Todos os produtos
Search

Este produto

    Mobile Platform as a Service:Guia de atualização do mPaaS 10.1.60

    Central de documentação

    Mobile Platform as a Service:Guia de atualização do mPaaS 10.1.60

    Última atualização: Jul 02, 2026

    Sobre o mPaaS 10.1.60

    1. A baseline 10.1.60 oferece suporte oficial à interface WKWebView. Para mais informações, consulte Adaptação do WKWebView para 10.1.60. A App Store da Apple deixou de aceitar novos aplicativos que usam UIWebView em abril de 2020 e parou de receber atualizações para aplicativos existentes com UIWebView em dezembro de 2020. Para mais detalhes, veja o anúncio oficial da Apple. Portanto, substitua o UIWebView pelo WKWebView.

    2. A baseline 10.1.60 é compatível com iOS 13 e Xcode 11. Para mais informações, consulte Adaptação do mPaaS 10.1.60 para iOS 13.

    3. Esta baseline introduz o componente Mini Program. A versão oficial desse componente disponibiliza um conjunto mais abrangente de APIs, além de melhorias significativas em estabilidade e compatibilidade. Para detalhes sobre a atualização do Mini Program, consulte Guia de atualização do Mini Program. Para saber mais sobre os novos recursos do IDE do Mini Program, como depuração, visualização prévia e publicação, acesse Desenvolver Mini Programs.

    4. A baseline 10.1.60 otimiza significativamente o container H5, simplificando o processo de integração e aprimorando as capacidades. Esta versão também traz melhorias notáveis de compatibilidade e estabilidade. Para orientações sobre a atualização do container H5 e dos pacotes offline, consulte Guia de atualização do Container H5.

    5. A baseline 10.1.60 adiciona o componente Smart Delivery. O Smart Delivery veicula anúncios personalizados dentro do aplicativo e permite publicidade direcionada a grupos específicos de usuários, ajudando os operadores a alcançar o público-alvo com precisão e agilidade. Para mais informações, consulte Smart Delivery.

    6. Esta baseline apresenta melhorias substanciais na compatibilidade, estabilidade e nos recursos dos componentes. Para consultar as notas de versão específicas, acesse Notas de versão do SDK para iOS.

    7. A baseline 10.1.60 não oferece mais suporte ao iOS 8.

    Guia de atualização do mPaaS 10.1.60

    Atualizar usando a mPaaS Xcode Extension (Recomendado)

    Pré-requisitos

    Verifique se a mPaaS Xcode Extension está atualizada para a versão 1.1.0 ou posterior. Para saber como atualizar a mPaaS Xcode Extension, consulte Atualizar a mPaaS Xcode Extension.

    Procedimento

    1. No menu do Xcode, clique em Editor > mPaaS > Edit Project para abrir a mPaaS Xcode Extension.

      • Caso tenha integrado a baseline 10.1.60-beta, selecione a opção Update Product Set para atualizar para o conjunto de produtos mais recente.

      • Se estiver usando uma versão de baseline diferente da 10.1.60-beta, selecione a opção Upgrade Baseline e defina a versão da baseline como 10.1.60. A atualização pode levar algum tempo. Não feche a janela do plugin durante o processo.

    2. Após a conclusão bem-sucedida da atualização, o plugin exibirá a versão do SDK do projeto como 10.1.60.

    Atualizar usando o plugin do mPaaS

    Pré-requisitos

    O plugin mPaaS do Xcode deve estar na versão 5.0.7 ou posterior.

    Procedimento

    1. Abra o painel do plugin no projeto atual.

      • Se você já integrou a baseline 10.1.60-beta, alterne para a opção mPaaS Product Set Update para obter o conjunto de produtos mais recente.

      • Para versões de baseline diferentes da 10.1.60-beta, escolha a opção mPaaS Baseline Upgrade e configure a versão para 10.1.60. Esse procedimento pode ser demorado. Mantenha a janela do plugin aberta até o fim.

    2. Quando a atualização for concluída com êxito, o plugin indicará que a versão do SDK do projeto é 10.1.60.

    Atualizar usando CocoaPods

    Pré-requisitos

    O plugin mPaaS para CocoaPods deve estar instalado.

    • Se ainda não instalou o plugin mPaaS para CocoaPods, execute o comando abaixo no terminal para instalá-lo.

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

    • Caso o plugin já esteja instalado, use o comando pod mpaas update --all para atualizá-lo. Para mais detalhes sobre o uso do plugin mPaaS para CocoaPods, consulte Integração baseada em framework nativo e CocoaPods.

    1. No Podfile, altere a configuração da versão do SDK para 10.1.60.10.1.60

    2. Execute pod mpaas update 10.1.60 para instalar o SDK mais recente da baseline 10.1.60.

    3. Execute pod install ou pod update conforme necessário para concluir a atualização do projeto para a versão 10.1.60.

    Próximos passos

    Se ocorrer um erro semelhante ao exemplo abaixo durante a integração com CocoaPods:

    Invalid `Podfile` file: [!] No mPaaS_Nebula : 10.1.60-beta found !!! Check name & version in Podfile.

    Siga estas etapas para resolver o problema:

    1. Execute o comando gem list | grep 'mPaaS' para verificar a versão do plugin do CocoaPods, conforme ilustrado na figura a seguir.

    2. Caso a versão do plugin do CocoaPods seja anterior à 0.9.5, execute o comando abaixo para reinstalar o plugin.

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

    Guia de atualização de uso de componentes

    A integração e o uso dos componentes de container H5, miniapp e hotpatching sofreram ajustes significativos na baseline 10.1.60. Se você tiver integrado esses componentes, leia atentamente as instruções a seguir:

    A baseline 10.1.60 introduz mudanças importantes na integração e no uso do container H5 e do miniapp. Caso tenha integrado esses componentes, leia com atenção as orientações abaixo:

    Alterações nas APIs dos componentes

    Os componentes do mPaaS receberam uma camada de adaptação a partir da baseline 10.1.32. Se você usa uma baseline que não emprega a API dessa camada de adaptação, consulte primeiramente Adaptação do mPaaS 10.1.32 para iOS 13.

    Após atualizar o SDK, passe a usar as APIs da camada de adaptação. Para mais informações, verifique as notas sobre atualização a partir de versões antigas nos seguintes documentos de componentes:

    Nota

    • Preste muita atenção às alterações na configuração dos componentes do mPaaS no seu projeto, como a categoria e as configurações no arquivo info.plist.

    • Modifique seu código para usar os métodos da camada intermediária (adaptador) em vez de chamar diretamente os métodos subjacentes. Alguns métodos de baixo nível podem ser alterados ou descontinuados em versões futuras. Se continuar a usá-los, você poderá gastar mais tempo adaptando seu código nas próximas atualizações.

    • O hotpatching para iOS está disponível apenas para o Apsara Stack. Para mais informações, entre em contato com o suporte técnico do mPaaS.

    Tratamento de bibliotecas personalizadas

    Muitos requisitos personalizados foram incorporados aos componentes padrão da baseline 10.1.60. No entanto, como precaução, caso seu projeto dependesse anteriormente de bibliotecas personalizadas e você esteja atualizando de uma versão inferior do SDK (como 10.1.32) para a 10.1.60, essas bibliotecas podem precisar ser recompiladas para a nova versão. abra um ticket ou contate o suporte do mPaaS para confirmar se essa etapa é necessária.