Connect cocoapods-art to Artifactory

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

CocoaPods Git Indexing Deprecation

Starting July 2025, you will only be able to configure CocoaPods repositories using CocoaPods CDN, and the use of the cocoapods-art plugin will be deprecated. For more information, see Deprecations in Process.Deprecations in Process

To resolve dependencies from CocoaPods repositories in Artifactory using the the cocoapods-art plugin, you must first connect it to Artifactory.

Prerequisite: Before connecting the plugin to Artifactory, you must have an existing CocoaPods repository in Artifactory. For more information, see Create a CocoaPods Repository.

To connect cocoapods-art to Artifactory:

  1. If needed, install the cocoapods-art plugin:

    gem install cocoapods-art

  2. Add the following authentication snippet to your .netrc file:

    machine [JFrogPlatformURL]
login <USERNAME>
password <AUTH>

    Where:

    • [JFrogPlatformURL]: Your organization's Artifactory hostname

    • <USERNAME>: Your Artifactory username

    • <AUTH>: Your Artifactory identity token

    For example:

    machine company.jfrog.io
login jeffry
password 51HnvD0A1g2q3n4b5F6g7H8j9K0l1m2N3o4P5q6R7s8T9u0V1w2X3y4

  3. Run the following command to add an Artifactory Specs repository to your CocoaPods client:

    pod repo-art add <REPO_NAME> "https://[JFrogPlatformURL]/artifactory/api/pods/<REPO_NAME>"

    Where:

    • <REPO_NAME>: The name of your CocoaPods repository in Artifactory

    • [JFrogPlatformURL]: Your organization's Artifactory URL

    For example:

    pod repo-art add cocoapods-local "https://company.jfrog.io/artifactory/api/pods/cocoapods-local"

  4. To make sure your local client has the latest index of pods available from the Artifactory repository, run this command:

    pod repo-art update

    Run this command periodically to keep your local client in sync.

Important

If you have removed the public CocoaPods master repository from your client and encounter errors related to the stats plugin, you may need to disable it by adding the following line to your Podfile or setting it as an environment variable:

ENV['COCOAPODS_DISABLE_STATS'] = 'true'

Once this configuration is complete, you can deploy and resolve pods in Artifactory using the cocoapods-art plugin.

Note

You can also use JFrog Set me up to copy the snippet populated with your token and environment. For more information, see Use Artifactory Set Me Up for Configuring Package Manager Clients.

Next steps: