• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Migrar o agente do iOS do CocoaPods

|View as Markdown (English)

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 NewRelicAgent já publicadas permanecem no CocoaPods, para que o pod install e 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 NewRelicAgent for o seu único pod, execute este comando no diretório do seu projeto e, em seguida, exclua o seu Podfile, Podfile.lock e o arquivo .xcworkspace que o CocoaPods gerou:

    bash
    $
    pod deintegrate
  • Se você ainda usa outro pod, exclua a linha pod 'NewRelicAgent' do seu Podfile e, em seguida, execute:

    bash
    $
    pod install

    Verifique se NewRelicAgent não aparece mais em seu Podfile.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-spm

Para 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 de Pods/, 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:

bash
$
xcodebuild -resolvePackageDependencies -project YourApp.xcodeproj -scheme YourApp

Migre 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

React Native

Ative o gerenciador de pacote do Swift em seu Podfile.

Flutter

Use o suporte ao gerenciador de pacote Swift do Flutter, que está ativado por padrão a partir do Flutter 3.44.

Ionic Capacitor

Mova seu projeto iOS para o gerenciador de pacote do Swift se ele ainda usar o CocoaPods.

Cordova

Atualize para cordova-ios 8 ou superior.

Unidade

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 => :dynamic no seu Podfile
  • Um bloco post_install no seu Podfile que chama react_native_post_install, como faz o modelo padrão do React Native

Para alternar, siga estas etapas:

  1. Atualize o agente React Native para a versão 1.9.3 ou superior.

  2. No topo do seu ios/Podfile, adicione:

    ENV['NEWRELIC_USE_SPM'] = '1'
    use_frameworks! :linkage => :dynamic
  3. Execute pod install no seu diretório ios e, em seguida, verifique se NewRelicAgent não aparece mais no seu Podfile.lock.

  4. 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:

  1. Atualize o agente React Native para a versão 1.9.3 ou superior.

  2. Instalar expo-build-properties:

    bash
    $
    npx expo install expo-build-properties
  3. Em seu app.json ou app.config.js, configure o iOS para usar frameworks dinâmicos:

    "plugins": [
    "newrelic-react-native-agent",
    ["expo-build-properties", { "ios": { "useFrameworks": "dynamic" } }]
    ]
  4. Adicione NEWRELIC_USE_SPM=1 ao arquivo .env no diretório raiz do seu projeto. npx expo prebuild e npx expo run:ios o carregam.

  5. Execute npx expo prebuild --clean, depois verifique se NewRelicAgent não aparece mais em ios/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:

bash
$
flutter config --enable-swift-package-manager

Remova 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/App tiver um pacote CapApp-SPM, você já usa o gerenciador de pacote Swift. npx cap sync manté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 comando npx cap spm-migration-assistant e 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:

  1. Atualize o agente Cordova para a versão mais recente.

  2. Atualize sua plataforma iOS. Consulte o anúncio de lançamento do cordova-ios 8:

    bash
    $
    cordova platform remove ios
    $
    cordova platform add ios@8

    Remover a plataforma exclui a pasta platforms/ios, portanto, você perde quaisquer alterações feitas lá manualmente. Faça um backup primeiro.

  3. Certifique-se de que seu config.xml defina o destino de implantação do iOS como 15.0 ou superior:

    <preference name="deployment-target" value="15.0" />
  4. 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.

Solucionar problemas

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.