Skip to content

๐Ÿˆ Cache CocoaPods for faster rebuild and indexing Xcode project.

License

Notifications You must be signed in to change notification settings

swiftyfinch/Rugby

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation




Motivation

Why do we need some optimizations while working on huge projects with CocoaPods?
- Slow and unnecessary indexing of pods targets, which implementation we rarely try to edit;
- Redundant rebuild time, probably as a result of problems, related to CocoaPods or Xcode;
- Freezing UI during navigating through a project or editing it;
- Broken or extremely slow autocompletion;
- Noisy laptop turbines, heated aluminum, and infinite spinning pinwheel.

More in the ๐Ÿ“– foundation and remastering stories.

Description

๐Ÿˆ Rugby is CLI tool that was developed to solve the above problems:
+ Cache all pods dependencies and remove their targets from the Pods project;
+ Rebuild only changed pods or even download them;
+ Delete any unneeded targets with sources from a project and reduce its size.

What makes it different?

๐Ÿ•Š Not a project dependency, just an optional step;
๐ŸŒฑ Doesn't change Podfile and Podfile.lock;
โœˆ๏ธ Can run a sequence of commands from a YAML file;
๐Ÿ•น๏ธ Single command usage;
๐Ÿณ Ready for remote cache;
๐Ÿงฃ Cozy log output;
๐Ÿš€ Swiftish and uses native Xcode build system.

Ruby alternatives: PodBuilder | CocoaPods Binary Cache | CocoaPods Binary


How to install ๐Ÿ“ฆ

First of all, if you have the first version Rugby 1.x, you need to delete it.
Then call where rugby command and be sure that there are no any of paths to rugby.

First Install

curl -Ls https://swiftyfinch.github.io/rugby/install.sh | bash

Self-Update

If you already have Rugby, which version is at least 2.0.0b2, you can use such a command.

> rugby update

Full Guide

Read more in the guide how to install it.
If you look for the legacy Rugby 1.x, visit this page.

How to use ๐Ÿˆ

Preconditions

  1. If you use Objective-C in your project, be sure that you import modules correctly.
    Use @import Something instead of #import "Something.h".
    Because Rugby will include built frameworks in your project;
  2. Before using Rugby you should be sure that your project source code is finalized.
    ๐Ÿ”ธ For example: if you use SwiftGen, run it before calling Rugby.
    Otherwise, your source code will be modified during building with Rugby. Then the hashes of binaries will not be suited.
    If you encounter a problem, try to use rugby build pre to prebuild your project and finalize source code;
  3. Be sure that all your pods (including development) are ready to build standalone.
    Otherwise, you can get a state when one of them can't be reused correctly without the source of its dependencies.
    As a temporary workaround, you can exclude some pods like rugby -e BadPod.
    ๐Ÿ”ธ For example: if some of your pods use incorrect headers.

Then run this command in your project directory after each pod install.
It will build all targets by default:

> rugby

Deintegrate it with the rollback command:

> rugby rollback

Also, you can write a custom plan (sequence of commands).
Use ๐Ÿˆ RugbyPlanner for visualizing changes in your project without applying them.
For advanced usage, please read the documentation below.

๐Ÿ“š Documentation

๐Ÿ“ฆ How to Install
๐Ÿ“– Commands Help
๐Ÿš Migration Guide
๐Ÿณ Remote Cache


๐Ÿค Contribution

Feel free to open a pull request or a discussion.

Known Issues ๐Ÿž
#394: Unable to run tests via Xcode (via make test they run perfectly)
#270: Missing public OutputType

๐Ÿ“ฎ Support

If you want to support this project, you can do some of these:
1) Press โญ๏ธ. It's a nice mark which means that Rugby is useful;
2) Share the project ๐ŸŒ somewhere with somebody;
3) Leave feedback in the discussions ๐Ÿ’ฌ section.

Let's Roll-oll ๐Ÿˆ