Skip to content

Commit 824d2e2

Browse files
authored
Added README about Apple silicon Macs (#7057)
* Added README about Apple silicon Macs. * Add link in README.
1 parent 646a922 commit 824d2e2

File tree

2 files changed

+53
-2
lines changed

2 files changed

+53
-2
lines changed

AppleSilicon.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Apple Silicon Simulator Support
2+
3+
If you're using Swift Package Manager or the zip file, everything should work for you
4+
using Xcode 12.0 or above. See the instructions below for CocoaPods and Carthage.
5+
6+
## CocoaPods
7+
8+
All source-based Firebase CocoaPods work as expected. Binary pods are listed below with the current
9+
status.
10+
11+
### Analytics + GoogleAppMeasurement
12+
13+
As of Firebase 7.2.0, FirebaseAnalytics and GoogleAppMeasurement provide a separate distribution of
14+
an XCFramework in order to work around an issue with CocoaPods and static XCFrameworks. This is a
15+
temporary workaround while Analytics is affected by the CocoaPods bug.
16+
17+
When specifying which version of Firebase you'd like in your Podfile, append `-M1` to the version.
18+
See the following examples:
19+
20+
```
21+
# Explicitly require the special `M1` tagged Firebase version.
22+
pod 'Firebase/Analytics', '~> 7.2.0-M1'
23+
24+
# Do the same for any other Firebase pod used.
25+
pod 'Firebase/Database', '~> 7.2.0-M1'
26+
27+
# You can also lock on the minor or major versions like so:
28+
pod 'Firebase/Analytics, '~> 7.2-M1'
29+
pod 'Firebase/Analytics, '~> 7-M1'
30+
```
31+
32+
The CocoaPods issue has been fixed in CocoaPods/CocoaPods#10234 but has not been included in a
33+
CocoaPods release yet.
34+
35+
### Performance
36+
37+
As of Firebase 7.2.0, FirebasePerformance uses an XCFramework for distribution that works with
38+
Apple silicon.
39+
40+
### FirebaseML
41+
42+
FirebaseML does not yet work with the simulator on Apple silicon Macs.
43+
44+
## Carthage
45+
46+
XCFrameworks are required to include the arm64 slice for iOS devices and the macOS simulator for
47+
Macs running on Apple silicon. Unfortunately, Carthage does not support XCFrameworks yet which
48+
prevents us from being able to include support. See Carthage/Carthage#2799 for progress.
49+

README.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,8 @@ See the subsections below for details about the different installation methods.
4545
### Standard pod install
4646

4747
Go to
48-
[https://firebase.google.com/docs/ios/setup](https://firebase.google.com/docs/ios/setup).
48+
[https://firebase.google.com/docs/ios/setup](https://firebase.google.com/docs/ios/setup). If you
49+
have a new Mac with an Apple silicon chip, please see [these instructions](AppleSilicon.md).
4950

5051
### Swift Package Manager (Beta)
5152

@@ -88,7 +89,8 @@ pod 'FirebaseMessaging', :path => '/path/to/firebase-ios-sdk'
8889
### Carthage (iOS only)
8990

9091
Instructions for the experimental Carthage distribution are at
91-
[Carthage](Carthage.md).
92+
[Carthage](Carthage.md). If you have a new Mac with an Apple silicon chip, please see
93+
[these instructions](AppleSilicon.md).
9294

9395
### Using Firebase from a Framework or a library
9496

0 commit comments

Comments
 (0)