Skip to content

Latest commit

 

History

History
115 lines (88 loc) · 7.84 KB

README.md

File metadata and controls

115 lines (88 loc) · 7.84 KB
Raw

Firestore iOS SDK Binary Distribution

Precompiled Firestore iOS SDK xcframework files extracted from the Firebase iOS SDK repository release downloads, tagged by Firebase iOS SDK version and presented as a consumable podspec.

Why

Currently the Firestore iOS SDK depends on some 500k lines of mostly C++, which when compiling as part of your Xcode build takes a long time - even more so in CI environments.

Related Issues

Before & After

Before and after timing below, timed when running Xcode build (with cache fully cleared) in a project with Firestore.

Mac mini (2018) 6 cores:

Before:    ~ 240s
After:     ~  45s

GitHub Action CI 2 cores:

Before:    ~ 551s
After:     ~ 174s

Usage

Integrating is as simple as adding 1 line to your main target in your projects Podfile. Any dependencies in your project that already consume the Firebase iOS SDK from pods will then automatically source Firestore from these precompiled binaries rather than from source.

  • For Flutter & React Native this file is usually located at ios/Podfile
  • For Flutter the target is usually called Runner and can be added inside the target 'Runner' do block in your podfile.
  • For React Native this would be inside the target that has all your local React-* pods included.
pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => '10.19.0'

⚠️ Note: where the tag says 10.19.0 this should be changed to the pod version of Firebase/Firestore that you or your dependencies are using - in the format X.X.X, for FlutterFire the version that is being used can be seen here, for React Native Firebase here. If no version is specified on your current Firebase/Firestore pod then you can omit , :tag => '10.19.0' from the line above and use the latest version on master/main.

The first time you pod install a specific version, CocoaPods will remotely retrieve this git repository at the specified tag and cache it locally for use as a source for the FirebaseFirestore pod.

⚠️ Note: if you were previously caching iOS builds on CI you may now find that when using precompiled binaries that caching is no longer required and it may actually slow down your build times by several minutes.

Supported Firebase iOS SDK versions

The below are the currently supported Firebase iOS SDK versions of this repository, this list is updated automatically.

⚠️ Note: if you are looking for a new version that is not listed in the supported versions list, examine the upstream release notes for firebase-ios-sdk carefully. This can happen if the firebase-ios-sdk team issues an interim release to solve some urgent problem, but do not run their full release process. If that happens, don't worry - just wait for the next supported version before moving forward, or temporarily de-integrate this pre-compiled framework if you must use the interim version. 6.31.1 is an example of this, with more details here for why it might happen.

...and more.

License

Built and maintained by Invertase.