full.md

< 📚 Commands Help

🏗️ Full

> rugby build full --help

 > Build targets as is.

 Options:
╭────────────────────────────────────────────────────────────────────────────────╮
│ -s, --sdk                  * Build SDK: sim or ios.                            │
│ -a, --arch                 * Build architecture: auto, x86_64 or arm64.        │
│ -c, --config               * Build configuration. (Debug)                      │
│ -t, --targets []           * Targets for building. Empty means all targets.    │
│ -g, --targets-as-regex []  * Targets for building as a RegEx pattern.          │
│ -e, --except []            * Exclude targets from building.                    │
│ -x, --except-as-regex []   * Exclude targets from building as a RegEx pattern. │
│ --result-bundle-path       * Path to xcresult bundle.                          │
│ -o, --output               * Output mode: fold, multiline, silent, raw.        │
╰────────────────────────────────────────────────────────────────────────────────╯
 Flags:
╭──────────────────────────────────────────────────╮
│ --strip           * Build without debug symbols. │
│ --ignore-cache    * Ignore shared cache.         │
│ -v, --verbose []  * Increase verbosity level.    │
│ -q, --quiet []    * Decrease verbosity level.    │
│ -h, --help        * Show help information.       │
╰──────────────────────────────────────────────────╯

Discussion

In the new 🏈 Rugby, you can build your Pods project without the step of integrating binaries into the project.
It allows us to build many times with different configurations and in the end use them all at once.

> rugby build --arch arm64 --sdk sim
> rugby build --arch arm64 --sdk ios
> rugby use

If it’s not necessary for you, use the cache command which is the combination of build and use.

> rugby build && rugby use

Or just:

> rugby cache

The command will create a build target and add existing ones as dependencies based on passed options.
Rugby doesn't build aggregate and test targets in the current implementation.
Then Rugby will build this target with the xcodebuild. And finally, move all binaries to ~/.rugby/bin folder.
You can find build logs in ~/.rugby/logs folder.

Also, this command doesn't rebuild targets if you already built them earlier. Rugby kept them in ~/.rugby/bin folder.
You can skip this behavior by passing a specific flag:

> rugby build --ignore-cache

Disable debug symbols generation

With this flag, Rugby will off debug symbols generation and strip all already generated symbols in selected targets.

> rugby build --strip

It can be valuable in enormous projects. Usually, we don't need to debug binaries.
It will be better to focus on a group of pods developing currently.
In some cases, it speeds up debugger attachment by 16x (147s vs 9s) in my work project.
Also, it slightly speeds up app launch time.