O CocoaPods anunciou que o seu registro central (trunk) se tornará permanentemente somente leitura em 2 de dezembro de 2026. Após essa data, o CocoaPods deixará de aceitar novas versões de pod. Esta página explica o que isso significa para o agente iOS do New Relic e para os agentes híbridos desenvolvidos sobre ele, e como mover seu aplicativo para outro método de instalação.
Antes de migrar
Revise estas respostas antes de migrar:
- What's changing? A versão 7.7.10 é o último agente iOS que publicamos no CocoaPods (o pod
NewRelicAgent). Versões posteriores estão disponíveis apenas por meio do gerenciador de pacote Swift e como um download do XCFramework. - Will my app break? Não. Todas as versões do
NewRelicAgentjá publicadas permanecem no CocoaPods, para que opod installe seus pipelines de CI continuem funcionando. Você apenas não obtém versões mais recentes do agente pelo CocoaPods. - Why migrate? Para continuar recebendo novos recursos, correções e suporte para novas versões do iOS e do Xcode, mude para o gerenciador de pacote Swift ou para o XCFramework.
Essa mudança também afeta os agentes híbridos que obtêm o agente iOS por meio do CocoaPods. Se você usar React Native, Flutter, Ionic Capacitor, Cordova ou Unity, consulte Migrar aplicativos que usam um agente híbrido.
Migre seu aplicativo iOS
Escolha um destes métodos de instalação:
- Gerenciador de pacote Swift: gerenciador de pacote da Apple, integrado ao Xcode. Você atualiza o agente pelo Xcode.
- XCFramework: um pacote de framework que você mesmo baixa e adiciona ao seu projeto. Você o atualiza baixando uma nova versão.
O agente iOS não depende de nenhum outro pacote, portanto, você pode movê-lo para o gerenciador de pacote Swift, mesmo que algumas de suas outras dependências permaneçam no CocoaPods por enquanto. Se você planeja remover todas as suas dependências do CocoaPods, verifique primeiro se cada uma delas é compatível com o gerenciador de pacote Swift. Para uma dependência que não seja compatível, o método XCFramework permite que você adicione e atualize o agente de forma independente de qualquer gerenciador de pacote.
Importante
Instale o agente com apenas um método. Se o pod NewRelicAgent ainda estiver instalado quando você adicionar o agente de outra forma, seu aplicativo acabará com duas cópias do agente, o que causa erros de compilação ou comportamento imprevisível.
Gerenciador de pacote Swift
Observe qual versão do agente você usa hoje. Está listada ao lado de NewRelicAgent no seu Podfile.lock.
Feche o Xcode e, em seguida, remova o pod NewRelicAgent:
Se
NewRelicAgentfor o seu único pod, execute este comando no diretório do seu projeto e, em seguida, exclua o seuPodfile,Podfile.locke o arquivo.xcworkspaceque o CocoaPods gerou:bash$pod deintegrateSe você ainda usa outro pod, exclua a linha
pod 'NewRelicAgent'do seuPodfilee, em seguida, execute:bash$pod installVerifique se
NewRelicAgentnão aparece mais em seuPodfile.lock.
Abra seu projeto no Xcode. Se você ainda usa outros pods, abra o arquivo .xcworkspace. Caso contrário, abra o arquivo .xcodeproj.
Selecione File > Add Package Dependencies... e insira este URL:
https://github.com/newrelic/newrelic-ios-agent-spmPara a regra de dependência, escolha Up to Next Major Version, a partir da versão que você anotou no primeiro passo ou de uma mais recente.
Adicione o produto de pacote NewRelic ao destino do seu aplicativo e a qualquer outro destino que usou o pod, como uma extensão de aplicativo.
Verifique seu script de compilação de upload de dSYM no Build Phases do seu destino:
- Se for o script para o agente iOS 7.4.0 ou superior (ele pesquisa por
run-symbol-tool), mantenha-o como está. Ele encontra a ferramenta no pacote Swift. - Se ele chamar
newrelic_postbuild.sh, ou usar um caminho dentro dePods/, substitua-o pelo script 7.4.0 ou superior da instalação do gerenciador de pacote Swift.
Mantenha o script como a última fase de compilação e certifique-se de que Based on dependency analysis esteja desmarcado.
Limpe e compile o seu aplicativo e, em seguida, execute-o. O código que inicia o agente e o token do seu aplicativo não mudam.
Para atualizar o agente mais tarde, consulte Atualizar com o gerenciador de pacote Swift.
XCFramework
Feche o Xcode e remova o pod NewRelicAgent, conforme descrito nas etapas do gerenciador de pacote Swift.
Siga a instalação manual do XCFramework para baixar o agente e adicioná-lo ao destino do seu aplicativo. Certifique-se de que NewRelic.xcframework esteja definido como Embed & Sign.
Verifique seu script de compilação de upload de dSYM conforme descrito nas etapas do gerenciador de pacote Swift. O script 7.4.0 ou superior encontra run-symbol-tool dentro de NewRelic.xcframework.
Limpe e compile o seu aplicativo e, em seguida, execute-o. O código que inicia o agente e o token do seu aplicativo não mudam.
Para atualizar o agente mais tarde, consulte Substituir manualmente o seu agente iOS.
Atualize seu pipeline de CI/CD
Se você removeu o CocoaPods completamente, atualize quaisquer etapas do pipeline que executem pod install ou compilem o arquivo .xcworkspace. Se você usa o gerenciador de pacote Swift, considere resolver os pacotes em uma etapa separada antes da compilação:
$xcodebuild -resolvePackageDependencies -project YourApp.xcodeproj -scheme YourAppMigre aplicativos que usam um agente híbrido
Os agentes híbridos incluem o agente iOS para você. A maioria deles pode obtê-lo por meio do CocoaPods ou do gerenciador de pacote Swift, e a configuração do projeto do seu aplicativo decide qual deles é usado:
Agente | O que fazer |
|---|---|
Ative o gerenciador de pacote do Swift em seu | |
Use o suporte ao gerenciador de pacote Swift do Flutter, que está ativado por padrão a partir do Flutter 3.44. | |
Mova seu projeto iOS para o gerenciador de pacote do Swift se ele ainda usar o CocoaPods. | |
Atualize para | |
Nenhuma ação necessária. Para obter versões mais recentes do agente iOS, adicione o XCFramework ao seu projeto do Xcode manualmente. | |
.NET MAUI e Unreal Engine | Nenhuma ação necessária. Esses agentes incluem o agente iOS em seu próprio pacote e não usam CocoaPods. |
Se o seu aplicativo continuar obtendo o agente iOS por meio do CocoaPods, você ainda poderá atualizar o seu agente híbrido. As novas versões do agente híbrido mantêm o agente iOS 7.7.10 para o CocoaPods e usam versões mais recentes do agente iOS apenas por meio do gerenciador de pacote Swift.
React Native
Por padrão, o agente do React Native obtém o agente do iOS a partir do CocoaPods. Você pode mudar para o gerenciador de pacote do Swift com o agente do React Native 1.9.3 ou superior.
Aplicativo React Native padrão
Antes de mudar, certifique-se de que seu aplicativo atenda a estes requisitos:
- React Native 0.75 ou superior
use_frameworks! :linkage => :dynamicno seuPodfile- Um bloco
post_installno seuPodfileque chamareact_native_post_install, como faz o modelo padrão do React Native
Para alternar, siga estas etapas:
Atualize o agente React Native para a versão 1.9.3 ou superior.
No topo do seu
ios/Podfile, adicione:ENV['NEWRELIC_USE_SPM'] = '1'use_frameworks! :linkage => :dynamicExecute
pod installno seu diretórioiose, em seguida, verifique seNewRelicAgentnão aparece mais no seuPodfile.lock.Crie e execute seu aplicativo.
Aplicativo Expo
npx expo prebuild regenera sua pasta ios, portanto, defina isso na configuração do seu projeto em vez de no Podfile. Você precisa do Expo SDK 52 ou superior.
Para alternar, siga estas etapas:
Atualize o agente React Native para a versão 1.9.3 ou superior.
Instalar
expo-build-properties:bash$npx expo install expo-build-propertiesEm seu
app.jsonouapp.config.js, configure o iOS para usar frameworks dinâmicos:"plugins": ["newrelic-react-native-agent",["expo-build-properties", { "ios": { "useFrameworks": "dynamic" } }]]Adicione
NEWRELIC_USE_SPM=1ao arquivo.envno diretório raiz do seu projeto.npx expo prebuildenpx expo run:ioso carregam.Execute
npx expo prebuild --clean, depois verifique seNewRelicAgentnão aparece mais emios/Podfile.lock.
Se NEWRELIC_USE_SPM não estiver definido quando o CocoaPods for executado, por exemplo, quando você mesmo executa pod install ou npx pod-install, seu aplicativo volta a obter o agente do iOS do CocoaPods.
Flutter
O agente Flutter é compatível com o CocoaPods e com o gerenciador de pacote Swift, e o Flutter decide qual deles usar. A partir do Flutter 3.44, o gerenciador de pacote Swift está ativado por padrão, portanto, a maioria dos aplicativos já obtém o agente iOS por meio dele.
Se você desativou o gerenciador de pacote Swift, ative-o novamente executando:
$flutter config --enable-swift-package-managerRemova também o enable-swift-package-manager: false do seu pubspec.yaml se você o tiver adicionado.
Ionic Capacitor
O agente Capacitor oferece suporte tanto ao CocoaPods quanto ao gerenciador de pacote Swift, e seu projeto iOS decide qual deles é usado. O Capacitor 8 cria novos projetos iOS com o gerenciador de pacote Swift, mas um projeto criado com o CocoaPods continua usando-o até que você o migre.
- Se a sua pasta
ios/Apptiver um pacoteCapApp-SPM, você já usa o gerenciador de pacote Swift.npx cap syncmantém o agente atualizado. - Se ele tiver um
Podfile, mova seu projeto para o gerenciador de pacote Swift seguindo o guia do gerenciador de pacote Swift do Capacitor. Ele abrange o comandonpx cap spm-migration-assistante a recriação da plataforma iOS.
Cordova
Com o cordova-ios 8 ou superior, o agente do Cordova obtém o agente do iOS por meio do gerenciador de pacote Swift. Versões anteriores do cordova-ios usam o CocoaPods.
Para migrar, siga estas etapas:
Atualize o agente Cordova para a versão mais recente.
Atualize sua plataforma iOS. Consulte o anúncio de lançamento do cordova-ios 8:
bash$cordova platform remove ios$cordova platform add ios@8Remover a plataforma exclui a pasta
platforms/ios, portanto, você perde quaisquer alterações feitas lá manualmente. Faça um backup primeiro.Certifique-se de que seu
config.xmldefina o destino de implantação do iOS como 15.0 ou superior:<preference name="deployment-target" value="15.0" />Crie e execute seu aplicativo.
Unidade
O agente do Unity obtém o agente do iOS por meio do CocoaPods, usando o Gerenciador de dependência externo para Unity (EDM4U). Ele não oferece suporte ao gerenciador de pacote Swift. Seu aplicativo continua sendo compilado com as versões já presentes no CocoaPods, e as novas versões do agente do Unity mantêm o agente do iOS 7.7.10.
Para usar uma versão mais recente do agente do iOS, adicione o XCFramework ao seu projeto do Xcode manualmente, conforme descrito nas etapas de dependência do agente do Unity. Certifique-se de que o EDM4U não instale também o pod NewRelicAgent, para que seu aplicativo tenha apenas uma cópia do agente.