/CocoaPods-app

A full-featured and standalone installation of CocoaPods.

Primary LanguageObjective-COtherNOASSERTION

CocoaPods.app Icon

CocoaPods.app

The foremost goal of CocoaPods.app is to provide a full-featured and standalone installation of CocoaPods, instead of requiring users to install CocoaPods through RubyGems or Homebrew. In addition to easy installation, it also includes ease of updating.

It is able to expose this standalone installation in a command-line interface environment through the pod command-line tool, which it will request to install on launch of the application or through the ‘Install the Command-Line Tool…’ menu item under the application menu.

Download

Scroll to after the CHANGELOG for download links.

Building for Development

If you want to hack on CocoaPods.app:

git clone https://github.com/CocoaPods/CocoaPods-app.git --recursive
cd CocoaPods-app
rake app:prerequisites --quiet
open app/CocoaPods.xcworkspace

This will set up your environment with a compiled versions of: ruby, git, cocoapods (the gem), hg, openssl, etc into both destroot and workbench.

Building for Release

A release build will require the OS X 10.8 SDK that comes with Xcode 5.1.1, which can be downloaded here.

The main tasks can be found with rake -T:

rake app:build               # Build release version of application
rake app:clean               # Clean
rake app:prerequisites       # Prepare all prerequisites for building the app
rake app:update_version      # Updates the Info.plist of the application to reflect the CocoaPods version
rake bundle:build            # Build complete dist bundle
rake bundle:clean:all        # Clean all artefacts, including downloads
rake bundle:clean:artefacts  # Clean build and destroot artefacts
rake bundle:submodules       # Ensure Submodules are downloaded
rake bundle:test             # Test bundle
rake bundle:verify_linkage   # Verifies that no binaries in the bundle link to incorrect dylibs
rake release                 # Create a clean release build for distribution
rake release:build           # Perform a full build of the bundle and app
rake release:cleanbuild      # Create a clean build
rake release:upload          # Upload release

If you’re working on the build system and want to debug intermediate steps, such as building Ruby, Git, Subversion, Mercurial, or Bazaar, be sure to checkout all the tasks with rake -T -A.

We have heard reports of issues with installing on custom ruby installations, we'd recommend using system ruby (rvm use system for example) during the installation process. Nothing will be installed into the system, it all goes into the destroot folder, but then you have the same environment we are using.

Creating a release

  1. Run rake release.
  2. Create a new ‘release’ on GitHub, which should show app specific changelog notes followed by the CocoaPods release changelog notes.
  3. Checkout the gh-pages branch: git clone https://github.com/CocoaPods/CocoaPods-app.git --branch gh-pages --single-branch gh-pages.
  4. Add gh-pages/releases/VERSION.html and recreate the changelog you added to the GitHub release as HTML.
  5. Update gh-pages/sparkle.xml to include the new version ‘item’.
  6. Make a pull request to https://github.com/caskroom/homebrew-cask/blob/master/Casks/cocoapods.rb updating the version and sha256