YJNCOPYCAT

Renaming an iOS app project is not exactly straightforward. I usually follow the steps outlined here: https://stackoverflow.com/a/35500038. As you can see, it's not as easy as it sounds.

YJNCopycat is a simple ruby script that clones a git repository containing an iOS Xcode project and renames it. You can use this gem either by a.) providing arguments in the commandline executable (--url, --name), or b.) by putting your specifications in a textfile: Copyfile. YJNCopycat will create a new folder in the current directory and download the project from the specified repo. It will proceed to rename the project, reinstall dependencies from CocoaPods, reinitialize git (will be optional in the next version), and then open the xcproject/xcworkspace file using your Xcode.

More options will be available soon.

Prerequisites

ruby 2.5.0
Xcode 8.0+

Installation

$ gem install yjncopycat

Usage

Just cd to where you want to clone your selected project repo.

a. CLI args

$ yjncopycat --name <NEW_PROJECT_NAME> --url <GIT_REPO_URL>

b. Copyfile

$ touch Copyfile
$ open Copyfile

This will be the format of Copyfile:

name <NEW_PROJECT_NAME>
url <GIT_REPO_URL>

Once the Copyfile is ready, run this:

$ yjncopycat run

If all goes well, Xcode will open your renamed project.

Development

After checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ffdelacruz/yjncopycat.

License

The gem is available as open source under the terms of the MIT License.