To develop Firebase software in this repository, ensure that you have at least
the following software:
For the pod that you want to develop:
pod gen Firebase{name here}.podspec --local-sources=./ --auto-open --platforms=ios
Note: If the CocoaPods cache is out of date, you may need to run
pod repo update before the pod gen command.
Note: Set the --platforms option to macos or tvos to develop/test for
those platforms. Since 10.2, Xcode does not properly handle multi-platform
CocoaPods workspaces.
Firestore has a self contained Xcode project. See
Firestore/README.md.
Development for Catalyst
pod gen {name here}.podspec --local-sources=./ --auto-open --platforms=ios- Check the Mac box in the App-iOS Build Settings
- Sign the App in the Settings Signing & Capabilities tab
- Click Pods in the Project Manager
- Add Signing to the iOS host app and unit test targets
- Select the Unit-unit scheme
- Run it to build and test
Adding a New Firebase Pod
See AddNewPod.md.
To ensure that the code is formatted consistently, run the script
./scripts/style.sh
before creating a PR.
Travis will verify that any code changes are done in a style compliant way. Install
clang-format and swiftformat.
These commands will get the right versions:
brew upgrade https://raw.githubusercontent.com/Homebrew/homebrew-core/c6f1cbd/Formula/clang-format.rb
brew upgrade https://raw.githubusercontent.com/Homebrew/homebrew-core/c13eda8/Formula/swiftformat.rb
Note: if you already have a newer version of these installed you may need to
brew switch to this version.
To update this section, find the versions of clang-format and swiftformat.rb to
match the versions in the CI failure logs
here.
Running Unit Tests
Select a scheme and press Command-u to build a component and run its unit tests.
Viewing Code Coverage (Deprecated)
First, make sure that xcov is installed with gem install xcov.
After running the AllUnitTests_iOS scheme in Xcode, execute
xcov --workspace Firebase.xcworkspace --scheme AllUnitTests_iOS --output_directory xcov_output
at Example/ in the terminal. This will aggregate the coverage, and you can run open xcov_output/index.html to see the results.
Running Sample Apps
In order to run the sample apps and integration tests, you'll need valid
GoogleService-Info.plist files for those samples. The Firebase Xcode project contains dummy plist
files without real values, but can be replaced with real plist files. To get your own
GoogleService-Info.plist files:
- Go to the Firebase Console
- Create a new Firebase project, if you don't already have one
- For each sample app you want to test, create a new Firebase app with the sample app's bundle
identifier (e.g.
com.google.Database-Example)
- Download the resulting
GoogleService-Info.plist and replace the appropriate dummy plist file
(e.g. in Example/Database/App/);
Some sample apps like Firebase Messaging (Example/Messaging/App) require
special Apple capabilities, and you will have to change the sample app to use a unique bundle
identifier that you can control in your own Apple Developer account.
