Automated Project Setup with FXIOS

Automatic Installation

The recommended way of setting up the repo is through the fxios tool. This tool provides multiple helpful commands to help manage the repo. Check out its documentation, or the repo, if you'd like to find out more. Setup allows cloning from an https or an ssh url.

Note that, if you're using a fork, you'll have to use the --with-fork <fork-url> option. This will set your fork as origin and the main firefox-ios repo as upstream. fork-url can be either the ssh or the https version.

brew tap mozilla-mobile/fxios
brew trust mozilla-mobile/fxios
brew install fxios

# Installing from the main repo
# You must specific if you want the https or ssh version of the mozilla-mobile repo
fxios setup --https # this will both download the repo & bootstrap both projects

# Installing with a fork workflow
fxios setup --ssh --with-fork <fork-url>

For more options for setup, please run fxios setup --help. Please note, this is a decently sized repo, so downloading might take a while depending on your connection.

Firefox Instructions

1. Open the Client.xcodeproj, under the firefox-ios/firefox-ios folder, in Xcode.
2. Make sure to select the Fennec scheme in Xcode.

⚠️ Important: In case you have dependencies issues with SPM, please try the following:

Xcode -> File -> Packages -> Reset Package Caches

Focus Instructions

1. Open Blockzilla.xcodeproj, under the firefox-ios/focus-ios folder, in Xcode.
2. Build the Focus scheme in Xcode.