Installation & Update

For more details, see 📝 CocoaPods 0.30 on our blog.

Enhancements

Radically reduce first run pod setup bandwidth by creating a shallow clone of the ‘master’ repo by default. Use the --no-shallow option to perform a full clone instead.
Jeff Verkoeyen #1803
Improves the error message when searching with an invalid regular expression.
Kyle Fuller
Improves pod init to save Xcode project file in Podfile when one was supplied.
Kyle Fuller
Adds functionality to specify a template URL for the pod lib create command.
Piet Brauer

Bug Fixes

Fixes a bug with pod repo remove silently handling permission errors.
Kyle Fuller #1778
pod push now properly checks that the repo has changed before attempting to commit. This only affected pods with special characters (such as +) in their names.
Gordon Fontenot #1739

0.29.0 (2013-12-25)

CocoaPods • CocoaPods-core • cocoapods-downloader

For more details, see 📝 CocoaPods 0.29 on our blog.

Breaking

The command podfile_info is now a plugin offered by CocoaPods. As a result, the command has been removed from CocoaPods.
Joshua Kalpin #1589
JSON has been adopted as the format to store specifications. As a result the pod ipc spec command returns a JSON representation and the YAML specifications are not supported anymore. JSON specifications adopt the .podspec.json extension. Fabio Pelosin #1568

Enhancements

Introduced pod try the easiest way to test the example project of a pod.
Fabio Pelosin #1568
Pod headers are now provided to the user target as a system header. This means that any warnings in a Pod's code will show under its target in Xcode's build navigator, and never under the user target.
Swizzlr #1596
Support LZMA2 compressed tarballs in the downloader.
Kyle Fuller cocoapods-downloader#5
Add Bazaar support for installing directly from a repo.
Fred McCann #1632
The pod search <query> command now supports regular expressions for the query parameter when searching using the option --full.
Florian Hanke #1643
Pod lib lint now accepts multiple podspecs in the same folder.
kra Larivain/OpenTable #1635
The pod push command will now silently test the upcoming CocoaPods trunk service. The service is only tested when pushing to the master repo and the test doesn't affect the normal workflow.
Fabio Pelosin
The pod search <query> command now supports searching on cocoapods.org when searching using the option --web. Options --ios and --osx are fully supported. Florian Hanke #1643
The pod search <query> command now supports multiword queries when using the --web option. Florian Hanke #1643

Bug Fixes

Fixed a bug which resulted in pod lib lint not being able to find the headers.
Fabio Pelosin #1566
Fixed the developer frameworks search paths so that $(SDKROOT)/Developer/Library/Frameworks is used for iOS and $(DEVELOPER_LIBRARY_DIR)/Frameworks is used for OS X.
Kevin Wales #1562
When updating the pod repos, repositories with unreachable remotes are now ignored. This fixes an issue with certain private repositories.
Joshua Kalpin #1595 #1571
The linter will now display an error if a Pod's name contains whitespace.
Joshua Kalpin Core#39 #1610
Having the silent flag enabled in the config will no longer cause issues with pod search. In addition, the flag --silent is no longer supported for the command.
Joshua Kalpin #1627
The linter will now display an error if a framework ends with .framework (i.e. QuartzCore.framework).
Joshua Kalpin #1331 Core#45
The linter will now display an error if a library ends with .a or .dylib (i.e. z.dylib). It will also display an error if it begins with lib (i.e. libxml).
Joshua Kalpin Core#44
The ARCHS build setting can come back as an array when more than one architecture is specified.
Carson McDonald #1628
Fixed all issues caused by /tmp being a symlink to /private/tmp. This affected mostly pod lib lint, causing it to fail when the Pod used prefix_header_* or when the pod headers imported headers using the namespaced syntax (e.g. #import <MyPod/Header.h>).
kra Larivain/OpenTable #1514
Fixed an incorrect path being used in the example app Podfile generated by pod lib create. Eloy Durán cocoapods-try#5

0.28.0 (2013-11-14)

CocoaPods • CocoaPods-core • CLAide

For more details, see 📝 CocoaPods 0.28 on our blog.

Enhancements

CLAide now supports gem plugins. An example CocoaPods plugin can be found at open_pod_bay.

As of yet there are no promises made yet on the APIs, so try to fail as gracefully as possible in case a CocoaPods update breaks your usage. In these cases, also please let us know what you would need, so we can take this into account when we do finalize APIs.

Les Hill CLAide#1 #959

Bug Fixes

Compiling xcassets with actool now uses UNLOCALIZED_RESOURCES_FOLDER_PATH instead of PRODUCT_NAME.WRAPPER_EXTENSION as output directory as it is more accurate and allows the project to overwrite WRAPPER_NAME.
Marc Knaup #1556
Added a condition to avoid compiling xcassets when WRAPPER_EXTENSION is undefined, as it would be in the case of static libraries. This prevents trying to copy the compiled files to a directory that does not exist.
Noah McCann #1521
Added additional condition to check if actool is available when compiling xcassets. This prevents build failures of Xcode 5 projects on Travis CI (or lower Xcode versions).
Michal Konturek #1511
Added a condition to properly handle universal or mac apps when compiling xcassets. This prevents build errors in the xcassets compilation stage particularly when using xctool to build.
Ryan Marsh #1594
Vendored Libraries now correctly affect whether a podspec is considered empty.
Joshua Kalpin Core#38
Vendored Libraries and Vendored Frameworks now have their paths validated correctly.
Joshua Kalpin #1567
Gists are now correctly accepted with https.
Joshua Kalpin Core#38
The pod push command is now more specific about the branch it pushes to.
orta #1561
Dtrace files are now properly left unflagged when installing, regardless of configuration.
Swizzlr #1560
Users are now warned if their terminal encoding is not UTF-8. This fixes an issue with a small percentage of pod names that are incompatible with ASCII.
Joshua Kalpin #1570

0.27.1 (2013-10-24)

For more details, see 📝 CocoaPods 0.27 and improved installation UX on our blog.

Enhancements

The xcodeproj gem now comes bundled with prebuilt binaries for the Ruby versions that come with OS X 10.8 and 10.9. Users now no longer need to install the Xcode Command Line Tools or deal with the Ruby C header location.
Eloy Durán Xcodeproj#88
Targets passed to the link_with method of the Podfile DSL no longer need to be explicitly passed as an array. link_with ['target1', 'target2'] can now be written as link_with 'target1', 'target2'.
Adam Sharp Core#30
The copy resources script now compiles xcassets resources.
Ulrik Damm #1427
pod repo now support a remove ['repo_name'] command.
Joshua Kalpin #1493 #1484

Bug Fixes

The architecture is now set in the build settings of the user build configurations.
Fabio Pelosin #1450 #1462
Fixed a crash related to CocoaPods being unable to resolve an unique build setting of an user target with custom build configurations.
Fabio Pelosin #1462 #1463 #1457
Fixed a defect which prevented subspecs from being dependant on a pod with a name closely matching the name of one of the subspec's parents.
Noah McCann #29
The developer dir relative to the SDK is not added anymore if testing frameworks are detected in OS X targets, as it doesn't exists, avoiding the presentation of the relative warning in Xcode.
Fabio Pelosin

0.26.2 (2013-10-09)

Bug Fixes

Fixed a crash which was causing a failure in pod lib create if the name of the Pod included spaces. As spaces are not supported now this is gracefully handled with an informative message.
Kyle Fuller #1456
If an user target doesn't specify an architecture the value specified for the project is used in CocoaPods targets.
Fabio Pelosin #1450
The Pods project now properly configures ARC on all build configurations.
Fabio Pelosin #1454

0.26.1 (2013-10-08)

For more details, see 📝 CocoaPods 0.26 on our blog.

Enhancements

CocoaPods now creates and hides the schemes of its targets after every installation. The schemes are not shared because the flag which keeps track whether they should be visible is a user only flag. The schemes are still present and to debug a single Pod it is possible to make its scheme visible in the Schemes manager of Xcode. This is rarely needed though because the user targets trigger the compilation of the Pod targets.
Fabio Pelosin #1185
Installations which don't integrate a user target (lint subcommands and --no-integrate option) now set the architecture of OS X Pod targets to $(ARCHS_STANDARD_64_BIT) (Xcode 4 default value for new targets). This fixes lint issues with Xcode 4.
Fabio Pelosin #1185
Further improvements to the organization of the Pods project
- The project is now is sorted by name with groups at the bottom.
- Source files are now stored in the root group of the spec, subspecs are not stored in a Subspec group anymore and the products of the Pods all are stored in the products group of the project.
- The frameworks are referenced relative to the Developer directory and namespaced per platform.
Fabio Pelosin #1389 #1420
Added the documentation_url DSL attribute to the specifications.
Fabio Pelosin #1273

Bug Fixes

The search paths of vendored frameworks and libraries now are always specified relatively.
Fabio Pelosin #1405
Fix an issue where CocoaPods would fail to work when used with an older version of the Active Support gem. This fix raises the dependency version to the earliest compatible version of Active Support.
Kyle Fuller #1407
CocoaPods will not attempt to load anymore all the version of a specification preventing crashes if those are incompatible.
Fabio Pelosin #1272

0.25.0 (2013-09-20)

Enhancements

Added support for Xcode 5.

The generated Pods Xcode project is now compatible with arm64 projects and is updated to use Xcode 5’s default settings removing all warnings.

NOTE to users migrating projects from Xcode 4, or are still using Xcode 4:
1. The Pods Xcode project now sets the ONLY_ACTIVE_ARCH build setting to YES in the Debug configuration. You will have to set the same on your project/target, otherwise the build will fail.
2. Ensure your project/target has an ARCHS value set, otherwise the build will fail.
3. When building a iOS project from the command-line, with the xcodebuild tool that comes with Xcode 4, you’ll need to completely disable this setting by appending to your build command: ONLY_ACTIVE_ARCH=NO.
#1352
Speed up project generation in pod install and pod update.
The pre and post install hooks that have been deprecated now include the name and version of the spec that’s using them.

Bug Fixes

Only create a single resource bundle for all targets. Prior to this change a resource bundle included into multiple targets within the project would create duplicately named targets in the Pods Xcode project, causing duplicately named Schemes to be created on each invocation of pod install. All targets that reference a given resource bundle now have dependencies on a single common target.

Blake Watters #1338
Solved outstanding issues with CocoaPods resource bundles and Archive builds:
1. The rsync task copies symlinks into the App Bundle, producing an invalid app. This change add --copy-links to the rsync invocation to ensure the target files are copied rather than the symlink.
2. The Copy Resources script uses TARGET_BUILD_DIR which points to the App Archiving folder during an Archive action. Switching to BUILT_PRODUCTS_DIR instead ensures that the path is correct for all actions and configurations.
Blake Watters #1309 #1329
Ensure resource bundles are copied to installation location on install actions Chris Gummer #1364
Various bugfixes in Xcodeproj, refer to its CHANGELOG for details.

0.24.0 (2013-09-04)

CocoaPods • cocoapods-core • Xcodeproj • cocoapods-downloader

Enhancements

Added pod init command which generates a Podfile according to the targets of the project stored in the working directory and to the templates stored in the ~/.cocoapods/templates folder. Two templates are supported:
- the Podfile.default template for regular targets.
- and the Podfile.test template for test targets. Ian Ynda-Hummel #1106 #1045
CocoaPods will now leverage the xcproj command line tool if available in the path of the user to touch saved projects. This will result in projects being serialized in the exact format used by Xcode eliminating merge conflicts and other related issues. To learn more about how to install xcproj see its readme. Cédric Luthi #1275
Rationalized and cleaned up Pods project group structure and path specification.
Create all necessary build configurations for Pods.xcodeproj at the project level. If the user’s project has more than just Debug and Release build configurations, they may be explicitly specified in the Podfile:
xcodeproj 'MyApp', 'App Store' => :release, 'Debug' => :debug, 'Release' => :release
If build configurations aren’t specified in the Podfile then they will be automatically picked from the user’s project in Release mode.
These changes will ensure that the libPods.a static library is not stripped for all configurations, as explained in #1217.
Cédric Luthi
#1294
Added basic support for Bazaar repositories.
Fred McCann
cocoapods-downloader#4

Bug Fixes

Fixed crash in pod spec cat.
Use the TARGET_BUILD_DIR environment variable for installing resource bundles.
Cédric Luthi
#1268
CoreData versioned models are now properly handled respecting the contents of the .xccurrentversion file.
Ashton-W
#1288, Xcodeproj#83
OS X frameworks are now copied to the Resources folder using rsync to properly overwrite existing files.
Nikolaj Schumacher
#1063
User defined build configurations are now added to the resource bundle targets.
#1309

0.23.0 (2013-08-08)

0.23.0.rc1 (2013-08-02)

CocoaPods • cocoapods-core • Xcodeproj • cocoapods-downloader

Enhancements

Added prepare_command attribute to Specification DSL. The prepare command will replace the pre_install hook. The post_install hook has also been deprecated. #1247

The reason we provided Ruby hooks at first, was because we wanted to offer the option to make any required configuration possible. By now, however, we have a pretty good idea of the use-cases and are therefore locking down the freedom that was once available. In turn, we’re adding attributes that can replace the most common use-cases. (See the enhancements directly following this entry for more info).

The second reason we need to lock this down is because this is the last remaining obstacle to fully serialize specifications, which we need in order to move to a ‘spec push’ web-service in the future.
Added resource_bundles attribute to the Specification DSL.
#743 #1186
Added vendored_frameworks attribute to the Specification DSL.
#809 #1075
Added vendored_libraries attribute to the Specification DSL.
#809 #1075
Restructured .cocoapods folder to contain repos in a subdirectory.
Ian Ynda-Hummel #1150
Improved pod spec create template.
#1223
Added copy&paste-friendly dependency to pod search.
#1073
Improved performance of the installation of Pods with git sources which specify a tag.
#1077
Core Data xcdatamodeld files are now properly referenced from the Pods project.
#1155
Removed punctuation check from the specification validations.
#1242
Deprecated the documentation attribute of the Specification DSL.
Core#20

Bug Fixes

Fix copy resource script issue related to filenames with spaces.
Denis Hennessy #1231

0.22.3 (2013-07-23)

Enhancements

Add support for .xcdatamodel resource files (in addition to .xcdatamodeld). #1201

Bug Fixes

Always exlude USE_HEADERMAP from the user’s project. #1216
Use correct template repo when using the pod lib create command. #1214
Fixed issue with pod push failing when the podspec is unchanged. It will now report [No change] ExamplePod (0.1.0) and continue to push other podspecs if they exist. #1199
Set STRIP_INSTALLED_PRODUCT = NO in the generated Pods project. This allows Xcode to include symbols from CocoaPods in dSYMs during Archive builds. #1217
Ensure the resource script doesn’t fail due to the resources list file not existing when trying to delete it. #1198
Fix handling of spaces in paths when compiling xcdatamodel(d) files. #1201

0.22.2 (2013-07-11)

Enhancements

The build settings of the Pods project and of its target have been updated to be in line with the new defaults of the future versions of Xcode.

Bug fixes

Specifications defining build setting with the [*] syntax are now properly handled. #1171
The name of the files references are now properly set fixing a minor regression introduced by CocoaPods 0.22.1 and matching more closely Xcode behaviour.
The validator now builds the Pods target instead of the first target actually performing the validation.
Build settings defined through the xcconfig attribute of a podspec are now stripped of duplicate values when merged in an aggregate target. #1189

0.22.1 (2013-07-03)

Bug fixes

Fixed a crash related to target dependencies and subspecs. #1168

0.22.0 (2013-07-03)

Enhancements

Added the pod lib create subcommand which allows to create a new Pod adhering to the best practices. The template is still a bit primitive and we encourage users to provide feedback by submitting patches and issues to https://github.com/CocoaPods/CocoaPods. #850
Added the pod lib lint subcommand which allows to lint the Pod stored in the working directory (a pod spec in the root is needed). This subcommand is equivalent to the deprecated pod spec lint --local. #850
The dependencies of the targets of the Pods project are now made explicit. #1165
The size of the cache used for the git repos is now configurable. For more details see https://github.com/CocoaPods/CocoaPods/blob/master/lib/cocoapods/config.rb#L7-L25 #1159
The copy resources shell script now aborts if any error occurs. #1098
The output of shell script build phases no longer includes environment variables to reduce noise. #1122
CocoaPods no longer sets the deprecated ALWAYS_SEARCH_USER_PATHS build setting.

Bug fixes

Pods whose head state changes now are correctly detected and reinstalled. #1160
Fixed the library reppresentation of the hooks which caused issues with the #copy_resources_script_path method. #1157
Frameworks symlinks are not properly preserved by the copy resources script. Thanks to Thomas Dohmke (ashtom) for the fix. #1063

0.21.0 (2013-07-01)

Bug fixes

Fixed a linter issue related to the dedicated targets change. #1130
Fixed xcconfig issues related to Pods including a dot in the name. #1152

0.21.0.rc1 (2013-06-18)

Enhancements

Pods are now built in dedicated targets. This enhancement isolates the build environment of each Pod from other ones eliminating pollution issues. It also introduces an important architectural improvement which lays the foundation for the upcoming CocoaPods features. Stay tuned! This feature has been implemented by Jeremy Slater. #1011 #983 #841
Reduced external dependencies and deprecation of Rake::FileList. #1080

Bug fixes

Fixed crash due to Podfile.lock containing multiple version requirements for a Pod. #1076
Fixed a build error due to the copy resources script using the same temporary file for multiple targets. #1099

0.20.2 (2013-05-26)

Bug fixes

Ensure that, in a sandbox-pod env, RubyGems loads the CocoaPods gem on system Ruby (1.8.7). #939
Allow sandbox-pod to execute any tool inside the Xcode.app bundle.
Allow sandbox-pod to execute any tool inside a rbenv prefix.

0.20.1 (2013-05-23)

CocoaPods • CLAide

Bug fixes

Made sandbox-pod executable visible as it wasn't correctly configured in the gemspec.
Made sandbox-pod executable actually work when installed as a gem. (In which case every executable is wrapped in a wrapper bin script and the DATA constant can no longer be used.)
Required CLAide 0.3.2 as 0.3.0 didn't include all the files in the gemspec and 0.3.1 was not correctly processed by RubyGems.

0.20.0 (2013-05-23)

CocoaPods • cocoapods-core • cocoapods-downloader • Xcodeproj • CLAide

Enhancements

Introduces an experimental sandbox feature. #939

Let’s face it, even though we have a great community that spends an amazing amount of time on curating the specifications, the internet can be a hostile place and the community is growing too large to take a naive approach any longer.

As such, we have started leveraging OS X’s sandbox facilities to disallow unsanctioned operations. This is still very experimental and therefore has to be used explicitely, for now, but that does not mean we don’t want you to start using it and report issues.

To use the sandbox, simply use the sandbox-pod command instead. E.g.:
```
  $ sandbox-pod install
```
In case of issues, be sure to check /var/log/system.log for ‘deny’ messages. For instance, here’s an example where the sandbox denies read access to /:
```
  May 16 00:23:35 Khaos kernel[0]: Sandbox: ruby(98430) deny file-read-data /
```
NOTE: The above example is actually one that we know of. We’re not sure yet which process causes this, but there shouldn’t be a need for any process to read data from the root path anyways.

NOTE 2: At the moment the sandbox is not compatible with the :path option when referencing Pods that are not stored within the directory of the Podfile.
The naked pod command now defaults to pod install. #958
CocoaPods will look for the Podfile in the ancestors paths if one is not available in the working directory. #940
Documentation generation has been removed from CocoaPods as it graduated to CocoaDocs. This decision was taken because CocoaDocs is a much better solution which doesn't clutter Xcode's docsets while still allowing access to the docsets with Xcode and with Dash. Removing this feature keeps the installer leaner and easier to develop and paves the way for the upcoming sandbox. Private pods can use pre install hook to generate the documentation. If there will be enough demand this feature might be reintegrated as plugin (see #1037).
Improved performance of the copy resources script and thus build time of the integrated targets. Contribution by @onato #1050.
The changelog for the current version is printed after CocoaPods is installed/updated. #853.

Bug fixes

Inheriting inhibit_warnings per pod is now working #1032
Fix copy resources script for iOS < 6 and OS X < 10.8 by removing the --reference-external-strings-file flag. #1030
Fixed issues with the :head option of the Podfile. #1046 #1039

0.19.1 (2013-04-30)

Bug fixes

Project-level preprocessor macros are not overwritten anymore. #903
A Unique hash instances for the build settings of the Pods target is now created resolving interferences in the hooks. #1014

0.19.0 (2013-04-30)

Enhancements

Compile time introspection. Macro definitions which allow to inspect the installed Pods and their version have been introduced in the build environment of the Pod libraries (example).
CocoaPods now defines the COCOAPODS=1 macro in the Pod and the Client targets. This is useful for libraries which conditionally expose interfaces. #903
Added support for the private_header_files attribute of the Specification DSL. #998
CocoaPods now defines the deployment target of the Pods project computed as the minimum deployment target of the Pods libraries. #556
Added pod podfile-info command. Shows list of used Pods and their info in a project or supplied Podfile. Options: --all - with dependencies. --md - in Markdown. #855
Added pod help command. You can still use the old format with --help flag. #957
Restored support for Podfiles named CocoaPods.podfile. Moreover, the experimental YAML format of the Podfile now is associated with files named CocoaPods.podfile.yaml. #1004

Deprecations

The :local flag in Podfile has been renamed to :path and the old syntax has been deprecated. #971

Bug fixes

Fixed issue related to pod outdated and external sources. #954
Fixed issue with .svn folders in copy resources script. #972

0.18.1 (2013-04-10)

Bug fixes

Fixed a bug introduced in 0.18 which cause compilation issue due to the quoting of the inherited value in the xcconfigs. #956
Robustness against user targets including build files with missing file references. #938
Partially fixed slow performance from the command line #919

0.18.0 (2013-04-08)

Enhancements

Added the ability to inhibit warnings per pod. Just pass :inhibit_warnings => true inline. This feature has been implemented by Marin Usalj (@mneorr). #10 #934
Inhibiting warnings will also suppress the warnings of the static analyzer.
A new build phase has been added to check that your installation is in sync with the Podfile.lock and fail the build otherwise. The new build phase will not be added automatically to targets already integrated with CocoaPods, for integrating targets manually see this comment. This feature has been implemented by Ullrich Schäfer (@stigi). #946
The pod search commands now accepts the --ios and the --osx arguments to filter the results by platform. #625
The developer frameworks are automatically added if SenTestingKit is detected. There is no need to specify them in specifications anymore. #771
The --no-update argument of the install, update, outdated subcommands has been renamed to --no-repo-update. #913

Bug fixes

Improved handling for Xcode projects containing non ASCII characters. Special thanks to Cédric Luthi (@0xced), Vincent Isambart (@vincentisambart), and Manfred Stienstra (@Manfred) for helping to develop the workaround. #926
Corrected improper configuration of the PODS_ROOT xcconfig variable in non-integrating installations. #918
Improved support for pre-release versions using dashes. #935
Documentation sets are now namespaced by pod solving improper attribution. #659

0.17.2 (2013-04-03)

Bug fixes

Fix crash related to the specification of the workspace as a relative path. #920
Fix an issue related to the podspec dsl directive of the Podfile for specifications with internal dependencies. #928
Fix crash related to search from the command line. #929

Ancillary enhancements

Enabled the FileList deprecation warning in the Linter.
CocoaPods will raise if versions requirements are specified for dependencies with external sources.
The exclude patterns now handle folders automatically.

0.17.1 (2013-03-30)

Bug fixes

Always create the CACHE_ROOT directory when performing a search. #917

0.17.0 (2013-03-29)

GM

Bug fixes

Don’t break when specifying doc options, but not appledoc ones. #906
Sort resolved specifications. #907
Subspecs do not need to include HEAD information. #905

Ancillary enhancements

Allow the analyzer to do its work without updating sources. motion-cocoapods#50

rc7

Bug fixes

Fixed an issue which lead to the missing declaration of the plural directives of the Specification DSL. #816
The resolver now respects the order of specification of the target definitions.
Restore usage of cache file to store a cache for expensive stats.
Moved declaration of Pod::FileList to CocoaPods-core.

Ancillary enhancements

Fine tuned the Specification linter and the health reporter of repositories.
Search results are sorted.

rc6

Bug fixes

CocoaPods updates the repositories by default. #872
Fixed a crash which was present when the Podfile specifies a workspace. #871
Fix for a bug which lead to a broken installation in paths containing brackets and other glob metacharacters. #862
Fix for a bug related to the case of the paths which lead to clean all files in the directories of the Pods.

Ancillary enhancements

CocoaPods now maintains a search index which is updated incrementally instead of analyzing all the specs every time. The search index can be updated manually with the pod ipc update-search-index command.
Enhancements to the pod repo lint command.
CocoaPods will not create anymore the pre commit hook in the master repo during setup. If already created it is possible remove it deleting the ~/.cocoapods/master/.git/hooks/pre-commit path.
Improved support for linting and validating specs repo.

rc5

Bug fixes

The --no-clean argument is not ignored anymore by the installer.
Proper handling of file patterns ending with a slash.
More user errors are raised as an informative.

rc4

Bug fixes

Restored compatibility with Podfile::TargetDefinition#copy_resources_script_name in the Podfile hooks.
Updated copy resources script so that it will use base internationalization #846
Robustness against an empty configuration file.
Fixed a crash with pod push #848
Fixed an issue which lead to the creation of a Pods project which would crash Xcode. #854
Fixed a crash related to a PBXVariantGroup present in the frameworks build phase of client targets. #859

Ancillary enhancements

The podspec option of the pod directive of the Podfile DSL now accepts folders.

rc3

[CocoaPods](https://github.com/CocoaPods/CocoaPods/compare/0.17.0.rc2...0.17.0.rc3 • Xcodeproj)

Bug fixes

CocoaPods will not crash anymore if the license file indicated on the spec doesn't exits.
Pre install hooks are called before the Pods are cleaned.
Fixed and issue which prevent the inclusion of OTHER_CFLAGS and OTHER_CPLUSPLUSFLAGS in the release builds of the Pods project.
Fixed pod lint --local
Fixed the --allow-warnings of pod push #835
Added copy_resources_script_name to the library representation used in the hooks. #837

Ancillary enhancements

General improvements to pod ipc.
Added pod ipc repl subcommand.

rc2

Bug fixes

Restored output coloring.
Fixed a crash related to subspecs #819
Git repos were not cached for dependencies with external sources. #820
Restored support for directories for the preserve_patterns specification attribute. #823

rc1

CocoaPods • Xcodeproj • cocoapods-core • cocoapods-downloader

Notice

At some point in future the master repo will be switched to the YAML format of specifications. This means that specifications with hooks (or any other kind of dynamic logic) will not be accepted. Please let us know if there is need for other DSL attributes or any other kind of support.

Currently the following specifications fail to load as they depended on the CocoaPods internals and need to be updated:

LibComponentLogging-pods/0.0.1/LibComponentLogging-pods.podspec
RestKit/0.9.3/RestKit.podspec
Three20/1.0.11/Three20.podspec
ARAnalytics/1.1/ARAnalytics.podspec

Other specifications, might present compatibility issues for the reasons presented below.

Breaking

Subspecs do not inherit the files patterns from the parent spec anymore. This feature made the implementation more complicated and was not easy to explain to podspecs maintainers. Compatibility can be easily fixed by adding a 'Core' subspec.
Support for inline podspecs has been removed.
The support for Rake::FileList is being deprecated, in favor of a more consistent DSL. Rake::FileList also presented issues because it would access the file system as soon as it was converted to an array.
The hooks architecture has been re-factored and might present incompatibilities (please open an issue if appropriate).
The requires_arc attribute default value is transitioning from false to true. In the meanwhile a value is needed to pass the lint.
Deprecated copy_header_mapping hook.
Deprecated exclude_header_search_paths attribute.
External sources are not supported in the dependencies of specifications anymore. Actually they never have been supported, they just happened to work.

DSL

Podfile:
- It is not needed to specify the platform anymore (unless not integrating) as CocoaPods now can infer the platform from the integrated targets.
Specification:
- preferred_dependency has been renamed to default_subspec.
- Added exclude_files attribute.
- Added screenshots attribute.
- Added default values for attributes like source_files.

Enhancements

Released preview documentation.
CocoaPods now has support for working in teams and not committing the Pods folder, as it will keep track of the status of the Pods folder. #552
Simplified installation: no specific version of ruby gems is required anymore.
The workspace is written only if needed greatly reducing the occasions in which Xcode asks to revert.
The Lockfile is sorted reducing the SCM noise. #591
Added Podfile, Frameworks, and Resources to the Pods project. #647 #588
Adds new subcommand pod spec cat NAME to print a spec file to standard output.
Specification hooks are only called when the specification is installed.
The --no-clean option of the pod spec lint command now displays the Pods project for inspection.
It is now possible to specify default values for the configuration in ~/.cocoapods/config.yaml (default values).
CocoaPods now checks the checksums of the installed specifications and reinstalls them if needed.
Support for YAML formats of the Podfile and the Specification.
Added new command pod ipc to provide support for inter process communication through YAML formats.
CocoaPods now detects if the folder of a Pod is empty and reinstalls it. #534
Install hooks and the prefix_header_contents attribute are supported in subspecs. #617
Dashes are now supported in the versions of the Pods. #293

Bug fixes

CocoaPods is not confused anymore by target definitions with different activated subspec. #535
CocoaPods is not confused anymore by to dependencies from external sources. #548
The git cache will always update against the remote if a tag is requested, resolving issues where library maintainers where updating the tag after a lint and would be confused by CocoaPods using the cached commit for the tag. #407 #596

Codebase

Major clean up and refactor of the whole code base.
Extracted the core classes into cocoapods-core gem.
Extracted downloader into cocoapods-downloader.
Extracted command-line command & option handling into CLAide.

0.16.4 (2013-02-25)

Enhancements

Add explicit flattening option to Downloader:Http: :flatten => true. #814 #812 #1314

Bug fixes

Explicitely require date in the gemspec for Ruby 2.0.0. 34da3f7

0.16.3 (2013-02-20)

Bug fixes

Only flatten tarballs, not zipballs, from HTTP sources. A zipball can contain single directories in the root that should be preserved, for instance a framework bundle. This reverts part of the change in 0.16.1. NOTE This will break some podspecs that were changed after 0.16.1. #783 #727
Never consider aggregate targets in the user’s project for integration. #729 #784
Support comments on all build phases, groups and targets in Xcode projects. #51
Ensure default Xcode project values are copied before being used. b43087c
Block assertions in Release builds. #53 #803 #802

Enhancements

Compile Core Data model files. #795
Add Xcodeproj::Differ, which shows differences between Xcode projects. 308941e

0.16.2 (2013-02-02)

Bug fixes

Quote storyboard and xib paths in ‘copy resource’ script. #740
Fix use of podspec directive in Podfile with no options specified. #768
Generate Mac OS X Pods target with the specified deployment target. #757
Disable libSystem objects for ARC libs that target older platforms. This applies when the deployment target is set to < iOS 6.0 or OS X 10.8, or not specified at all. #352 #1161
Mark header source files as ‘Project’ not ‘Public’. #747
Add PBXGroup as acceptable PBXFileReference value. #49
Make xcodeproj show without further arguments actually work. #45

Enhancements

Added support for pre-download over Mercurial. #750

0.16.1 (2013-01-13)

Bug fixes

After unpacking source from a HTTP location, move the source into the parent dir if the archive contained only one child. This is done to make it consistent with how source from other types of locations are described in a podspec. NOTE This might break some podspecs that assumed the incorrect layout. #727 #728
Remove duplicate option in pod update command. #725
Memory fixes in Xcodeproj. #43

Xcodeproj Enhancements

Sort contents of xcconfig files by setting name. #591
Add helpers to get platform name, deployment target, and frameworks build phases
Take SDKROOT into account when adding frameworks.

0.16.0 (2012-11-22)

Enhancements

Use Rake 0.9.4 #657

0.16.0.rc5 (2012-11-14)

Deprecated

The usage of specifications defined in a Podfile is deprecated. Use the :podspec option with a file path instead. Complete removal will most probably happen in 0.17.0. #549 #616 #525

Bug fixes

Always consider inline podspecs as needing installation.
Fix detection when the lib has already been integrated with the user’s target. #643 #614 #613

0.16.0.rc4 (2012-11-14)

Bug fixes

Fix for Rake 0.9.3 #657

0.16.0.rc3 (2012-11-02)

Enhancements

Added support for copying frameworks to the app bundle. #597

Bug fixes

Ignore PBXReferenceProxy while integrating into user project. #626
Added support for PBXAggregateTarget and PBXLegacyTarget. #615
Added support for PBXReferenceProxy. #612

0.16.0.rc2 (2012-10-21)

Bug fixes

Fix for uninitialized constant Xcodeproj::Constants error.

0.16.0.rc1 (2012-10-21)

Enhancements

Xcodeproj partial rewrite. #565 #561
- Performance improvements in the Generating support files phase.
- Better support for editing existing projects and sorting groups.

0.15.2 (2012-10-19)

Enhancements

Added support for .hh headers. #576

Bug fixes

Restored support for running CocoaPods without a terminal. #575 #577
The git cache now always uses a barebones repo preventing a number of related issues. #581 #569
Improved fix for the issue that lead to empty directories for Pods. #572 #602
Xcodeproj robustness against invalid values, such as malformed UTF8. #592

0.15.1 (2012-10-04)

Enhancements

Show error if syntax error in Podfile or Podfile.lock.

Bug fixes

Fixed an issue that lead to empty directories for Pods. #519 #568
Fixed a crash related to the RubyGems version informative. #570
Fixed a crash for pod outdated. #567
Fixed an issue that lead to excessively slow sets computation.

0.15.0 (2012-10-02)

Enhancements

Pod install will update the specs repo only if needed. #533
CocoaPods now searches for the highest version of a Pod on all the repos. #85
Added a pre install hook to the Podfile and to root specifications. #486
Support for header_mappings_dir attribute in subspecs.
Added support for linting a Podspec using the files from its folder pod spec lint --local
Refactored UI.
Added support for Podfiles named CocoaPods.podfile which allows to associate an editor application in Mac OS X. #528
Added config option to disable the new version available message. #448
Added support for extracting .tar.bz2 files #522
Improved feedback for errors of repo subcommands. #505

Bug fixes

Subspecs namespacing has been restored. #541
Improvements to the git cache that should be more robust. #517
- In certain conditions pod setup would execute twice.
The git cache now is updated if a branch is not found #514
Forcing UTF-8 encoding on licenses generation in Ruby 1.9. #530
Added support for .hpp headers. #244

0.14.0 (2012-09-10)

Bug fixes

In certain conditions the spec of an external would have been overridden by the spec in the root of a Pod. #489
CocoaPods now uses a recent version of Octokit. #490
Fixed a bug that caused Pods with preferred dependencies to be always installed. Specs#464
Fixed Xcode 4.4+ artwork warning. Specs#508

0.14.0.rc2 (2012-08-30)

Bug fixes

Fix incorrect name for Pods from external sources with preferred subspecs. #485
Prevent duplication of Pod with a local source and mutliple activated specs. #485
Fixed the uninitialized constant Pod::Lockfile::Digest error. #484

0.14.0.rc1 (2012-08-28)

Enhancements

Improve installation process by preserving the installed versions of Pods across installations and machines. A Pod is reinstalled if:
- the version required in the Podfile changes and becomes incompatible with the installed one. #191
- the external source changes.
- the head status changes (from disabled to enabled or vice-versa).
Introduce pod update command that installs the dependencies of the Podfile ignoring the lockfile Podfile.lock. #131
Introduce pod outdated command that shows the pods with known updates.
Add :local option for dependencies which will use the source files directly from a local directory. This is usually used for libraries that are being developed in parallel to the end product (application/library). #458, #415, #156.
Folders of Pods which are no longer required are removed during installation. #298
Add meaningful error messages
- ia podspec can’t be found in the root of an external source. #385, #338, #337.
- a subspec name is misspelled. #327
- an unrecognized command and/or argument is provided.
The subversion downloader now does an export instead of a checkout, which makes it play nicer with SCMs that store metadata in each directory. #245
Now the Podfile is added to the Pods project for convenient editing.

Bug fixes

The git cache now fetches the tags from the remote if it can’t find the reference.
Xcodeproj now builds on 10.6.8 and Travis CI without symlinking headers.
Only try to install, add source files to the project, and clean a Pod once. #376

Notes

External Pods might be reinstalled due to the migration to the new Podfile.lock.
The SCM reference of head Pods is not preserved across machines.
Pods whose inline specification changed are not detected as modified. As a workaround, remove their folder stored in Pods.
Pods whose specification changed are not detected as modified. As a workaround, remove their folder stored in Pods.

0.13.0 (2012-08-22)

Enhancements

Add Podfile podspec which allows to use the dependencies of a podspec file. #162
Check if any of the build settings defined in the xcconfig files is overridden. #92
The Linter now checks that there are no compiler flags that disable warnings.

Bug fixes

The final project isn’t affected anymore by the inhibit_all_warnings! option.
Support for redirects while using podspec from an url. #462

0.12.0 (2012-08-21)

Enhancements

The documentation is generated using the public headers if they are specified.
In case of a download failure the installation is aborted and the error message is shown.
Git submodules are initialized only if requested.
Don’t impose a certain structure of the user’s project by raising if no ‘Frameworks’ group exists. #431
Support for GitHub Gists in the linter.
Allow specifying ARC settings in subspecs.
Add Podfile inhibit_all_warnings! which will inhibit all warnings from the Pods library. #209
Make the Pods Xcode project prettier by namespacing subspecs in nested groups. #466

0.11.1 (2012-08-09)

Bug fixes

Fixed a crash related to subspecs without header files. [#449]
Git submodules are loaded after the appropriate referenced is checked out and will be not loaded anymore in the cache. [#451]
Fixed SVN support for the head version. [#432]

0.11.0 (2012-08-08)

Enhancements

Added support for public headers. [#440]
Added pod repo lint. [#423]
Improved support for :head option and SVN repositories.
When integrating Pods with a project without "Frameworks" group in root of the project, raise an informative message. #431
Dropped support for legacy config.ios? and config.osx?

Bug fixes

Version message now correctly terminates with a 0 exit status.
Resolved an issue that lead to git error messages in the error report.

0.10.0 (2012-07-29)

Enhancements

Added a --local-only option to pod push so that developers can push locally and test before pushing to a remote. #405
Added line number information for errors generated in the Podfile. #408
Pods stored in git repositories now initialize submodules. #406

Bug fixes

Removed note about the post install hook form the linter.
Improved xcodebuild error detection in the linter.
Ensure the git cache exists, before updating it, when trying to install the ‘bleeding edge’ of a pod. #426
Clean downloaded external pods after resolving and activating (sub)specs. #414
Support tar.gz as filename in a HTTP source. #428

0.9.2 (2012-07-16)

Bug fixes

When generating the PodsDummy class, make that class unique to each target. #402
Raise an informative error message when the platform in the Podfile is omitted or incorrect. #403

0.9.1 (2012-07-14)

Bug fixes

CocoaPods 0.9.x needs Xcodeproj 0.3.0.

0.9.0 (2012-07-14)

Enhancements

Force downloading the ‘bleeding edge’ version of a pod with the :head flag. #392
Support for weak frameworks. #263
Use double quotes when shelling out. This makes a url like $HOME/local/lib work. #396

Bug fixes

Relaxed linter to accepts pod that only specify paths to preserve (like TuneupJS).
Gender neutralization of podfile documentation. #384
Exit early when using an old RubyGems version (< 1.4.0). These versions contain subtle bugs related to prerelease version comparisons. Unfortunately, OS X >= 10.7 ships with 1.3.6. #398

0.8.0 (2012-07-09)

Breaking change

Syntax change in Podfile: dependency has been replaced by pod.

ruby platform :ios pod 'JSONKit', '~> 1.4' pod 'Reachability', '~> 2.0.4'

Bug fixes

Properly quote all paths given to Git.

0.7.0 (2012-07-06)

Features

Added support for branches in git repos.
Added support for linting remote files, i.e. pod spec lint http://raw/file.podspec.
Improved Spec create template.
The indentation is automatically stripped for podspecs strings.

Bug fixes

The default warnings of Xcode are not overriden anymore.
Improvements to the detection of the license files.
Improvements to pod spec lint.
CocoaPods is now case insensitive.

0.6.1 (2012-07-01)