Create a CocoaPods Repository

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

This topic describes how to create a CocoaPods repository. This is required before publishing and installing pods. There are three primary types of repositories:

  • Local repositories: Store and share first- and second-party packages with your organization

  • Remote repositories: Download packages from remote locations, including external package registries or other Artifactory instances

  • Virtual repositories: Aggregate remote and local repositories, enabling your organization to scale by providing a single URL that provides access to multiple repositories and types

For more information on JFrog repositories, see Repository Management Overview.

Prerequisite: You need Admin or Project Admin permissions in Artifactory to create a repository.

To create a CocoaPods repository:

  1. In the Administration tab, click Repositories | Create a Repository.

    CreateAnsibleLocal1.png

  2. Select the type of repository you want to create: local, remote, or virtual.

  3. Select the CocoaPods package type.

  4. Configure the required fields for the repository:

    • For local repositories, in the Repository Key field, type a meaningful name for the repository. For example, cocoapods-local. For more information on local repositories and their settings, see Local Repositories.

    • For remote repositories, verify the Repository URL and update as needed. For more information on remote repositories and their settings, see Remote Repositories.

      By default, the CDN URL field points to the public registry https://cdn.cocoapods.org/. To use a different URL, define it in the CDN URL field, or modify the podsCdnUrl parameter via REST API.

      Note

      The public CocoaPods infrastructure consists of two main parts: the specs index provided by the CDN, and the actual source code archives, which are typically hosted on Git providers like GitHub. To effectively cache all components, your remote repository's URL should point to the Git provider (for example, https://github.com), while the CDN URL field points to the specs index (https://cdn.cocoapods.org/).

      Tip

      If you are proxying a private Bitbucket Server (formerly known as Stash), ensure you select Stash as the Git Provider in the repository configuration, not Bitbucket. The public Bitbucket Cloud API behaves differently, and selecting the wrong provider can lead to resolution failures.

    • For virtual repositories, select one or more local or remote repository types to include in the virtual repository. For more information on virtual repositories and their settings, see Virtual Repositories.

      Virtual repositories are compatible only with the CocoaPods CDN. All local and remote repositories included in the virtual repository must also be CDN-compatible. For more information, see Identify Whether a CocoaPods Repository Uses CDN.

  5. Click Create Repository. The repository is created and the Repositories window is displayed.