# cocoapods-pack

A CocoaPods plugin that converts a given podspec into its binary version.

For a given podspec, a zip file will be produced containing the binary representation of the original podspec sources. Each platform is packed as an `xcframework` within the zip file. Other attributes such as `resource_bundles` specified in the source podspec will also be packed. A binary podspec is also generated that can be published to a CocoaPods specs repo.

You may choose to use `cocoapods-pack` as a packaging tool and write your own Swift Package Manager `Package.swift` file for the generated package instead.

Finally, you may choose to write your own CocoaPods plugin that leverages `cocoapods-pack` to prebuild CocoaPods dependencies before integrating them into a project.


## Installation

```
gem install cocoapods-pack
```

## Usage
```
$ pod pack SOURCE ARTIFACT_REPO_URL

      Converts the provided `SOURCE` into a binary version with each platform packed
      as an `xcframework`. The process includes installing a CocoaPods sandbox,
      building it for device and simulator using the 'Release' configuration, zipping
      the output and generating a new podspec that uses the `ARTIFACT_REPO_URL`
      provided as the source. The generated podspec is also validated.

Options:

    --use-static-frameworks                           Produce a framework that wraps a
                                                      static library from the source
                                                      files. By default dynamic
                                                      frameworks are used.
    --generate-module-map                             If specified, instead of using
                                                      the default generated umbrella
                                                      module map one will be generated
                                                      based on the frameworks header
                                                      dirs.
    --allow-warnings                                  Lint validates even if warnings
                                                      are present.
    --repo-update                                     Force running `pod repo update`
                                                      before install.
    --out-dir                                         Optional directory to use to
                                                      output results into. Defaults to
                                                      current working directory.
    --skip-validation                                 Skips linting the generated
                                                      binary podspec.
    --skip-platforms                                  Comma-delimited platforms to
                                                      skip when creating a binary.
    --xcodebuild-opts                                 Options to be passed through to
                                                      xcodebuild.
    --use-json                                        Use JSON for the generated
                                                      binary podspec.
    --sources=https://github.com/artsy/Specs,master   The sources from which to pull
                                                      dependant pods (defaults to all
                                                      available repos). Multiple
                                                      sources must be comma-delimited.
    --allow-root                                      Allows CocoaPods to run as root
    --silent                                          Show nothing
    --verbose                                         Show more debugging information
    --no-ansi                                         Show output without ANSI codes
    --help                                            Show help banner of specified
                                                      command
```

## Examples

To run some of the examples in this repo make sure you run `bundle install` first.

```
bundle exec pod pack samples/MySample/MySample.podspec https://url/to/MySample.zip --out-dir=out
```

If you wish to skip a specific platform the source podspec provides:

```
bundle exec pod pack samples/MySample/MySample.podspec https://url/to/MySample.zip --skip-platforms=watchos --out-dir=out
```

Using static linking:

```
bundle exec pod pack samples/MySample/MySample.podspec https://url/to/MySample.zip --use-static-frameworks --out-dir=out
```

Additional `xcodebuild` options can be passed using `--xcodebuild-opts `, example:

```
bundle exec pod pack samples/MySample/MySample.podspec https://url/to/MySample.zip --use-static-frameworks --xcodebuild-opts=ENABLE_BITCODE=NO --out-dir=out
```

You may also specify a remote podspec without the need to clone its sources locally, for example:

```
bundle exec pod pack https://raw.githubusercontent.com/Alamofire/Alamofire/master/Alamofire.podspec https://url/to/Alamofire.zip --out-dir=out --allow-warnings
```

## Developing

Install Ruby >= 2.5.0 and set up with:

```
$ bundle
```

To run the unit tests use `rake`:

```
$ bundle exec rake spec
```

Or, for a more thorough output which include test names:

```
$ bundle exec rspec --format d
```