c7ae591364
This avoids a problem where we might accidentally link with private symbols
exported by libicucore.dylib instead of the same symbols provided in a static
library.
This would show up as an App Store rejection:
TMS-90338: Non-public API usage - The app references non-public symbols:
_ubrk_openRules, _ucal_add, _ucal_close, _ucal_get, _ucal_getAttribute,
_ucal_getKeywordValuesForLocale, _ucal_getNow, _ucal_getTimeZoneDisplayName,
_ucal_getTimeZoneIDForWindowsID, _ucal_getWindowsTimeZoneID, _ucal_open,
_ucal_openTimeZoneIDEnumeration, _ucal_set, _ucal_setMillis, _ucol_close,
_ucol_closeElements, _ucol_getOffset, _ucol_getRules, _ucol_getSortKey,
_ucol_getStrength, _ucol_getVersion, _ucol_next, _ucol_open,
_ucol_openElements, _ucol_openRules, _ucol_previous, _ucol_safeClone,
_ucol_setAttribute, _ucol_setVariableTop, _ucol_strcoll, _ucurr_forLocale,
_ucurr_getName, _udat_close, _udat_countSymbols, _udat_format,
_udat_getSymbols, _udat_open, _udat_setCalendar, _udat_toPattern,
_udata_setCommonData, _udatpg_close, _udatpg_getBestPattern, _udatpg_open,
_uenum_close, _uenum_count, _uenum_next, _uldn_close,
_uldn_keyValueDisplayName, _uldn_open, _uloc_canonicalize,
_uloc_countAvailable, _uloc_getAvailable, _uloc_getBaseName,
_uloc_getCharacterOrientation, _uloc_getCountry, _uloc_getDefault,
_uloc_getDisplayCountry, _uloc_getDisplayLanguage, _uloc_getDisplayName,
_uloc_getISO3Country, _uloc_getISO3Language, _uloc_getKeywordValue,
_uloc_getLCID, _uloc_getLanguage, _uloc_getName, _uloc_getParent,
_uloc_setKeywordValue, _ulocdata_getCLDRVersion,
_ulocdata_getMeasurementSystem, _unorm2_getNFDInstance,
_unorm2_getNFKCInstance, _unorm2_getNFKDInstance, _unorm2_isNormalized,
_unum_close, _unum_getAttribute, _unum_getSymbol, _unum_open, _unum_toPattern,
_ures_close, _ures_getByKey, _ures_getSize, _ures_getStringByIndex,
_ures_open, _usearch_close, _usearch_first, _usearch_getBreakIterator,
_usearch_getMatchedLength, _usearch_last, _usearch_openFromCollator,
_usearch_setPattern, _usearch_setText.
This is what happens:
1. Mono uses ICU for various purposes, and we ship the corresponding helper
code as a static library (libicui18n.a).
2. iOS also uses ICU, and does so privately, we have no access to iOS’ copy of
those libraries.
3. FirebaseDatabase links with libicucore.dylib (this is a dylib shipped in
iOS). I’m not exactly sure why FirebaseDatabase does this, but it seems to
be allowed by Apple.
4. libicucore.dylib exports some of the symbols from iOS’ (private) copy of
ICU. I’m assuming this is just an implementation detail on Apple’s side,
and why they’ve added checks to the App Store to reject any apps that
reference these private symbols. When using FirebaseDatabase, we end up
asking the native linker to link with libicucore.dylib (-licucore) due to
the LinkerFlags in the NativeReference item.
5. We already ask the native linker to link with our own static version of ICU
(from step 1) – by passing the path to the static library in question
(libicui18n.a)
6. Depending on which native linker argument comes first (-licucore or
libicui18n.a) the native linker will find the symbols in one place or the
other. If found in Apple’s libicucore.dylib, the app ends up rejected by
the App Store.
So avoid all of this by making FirebaseDatabase not link with
libicucore.dylib.
|
||
|---|---|---|
| .ci | ||
| deprecated | ||
| docs | ||
| icons | ||
| samples | ||
| source | ||
| .editorconfig | ||
| .gitignore | ||
| Directory.Build.props | ||
| License.md | ||
| Readme.md | ||
| SignList.xml | ||
| Xamarin.Google.NuGet.Legacy.sln | ||
| Xamarin.Google.NuGet.sln | ||
| Xamarin.Google.sln | ||
| azure-pipelines-compliance.yml | ||
| azure-pipelines.yml | ||
| build.cake | ||
| cgmanifest.json | ||
| common.cake | ||
| components.cake | ||
| custom_externals_download.cake | ||
| global.json | ||
| manifest.yaml | ||
| poco.cake | ||
| update.cake | ||
Readme.md
Xamarin Components for Google APIs for iOS
Xamarin creates and maintains Xamarin.iOS bindings for the Google APIs for iOS Libraries, including:
Active Libraries
Deprecated Libraries
Firebase APIs for iOS current global version
Here's a table that shows in which global version is located each component of Firebase at this point of history:
| Component Name | Component Version | Global Version |
|---|---|---|
| Firebase A/B Testing | 8.10.0 | 8.10.0 |
| Firebase AdMob | 8.10.0 | 8.10.0 |
| Firebase Analytics | 8.10.0 | 8.10.0 |
| Firebase Auth | 8.10.0 | 8.10.0 |
| Firebase Cloud Firestore | 8.10.0 | 8.10.0 |
| Firebase Cloud Functions | 8.10.0 | 8.10.0 |
| Firebase Cloud Messaging | 8.10.0 | 8.10.0 |
| Firebase Core | 8.10.0 | 8.10.0 |
| Firebase Crashlytics | 8.10.0 | 8.10.0 |
| Firebase Database | 8.10.0 | 8.10.0 |
| Firebase Dynamic Links | 8.10.0 | 8.10.0 |
| Firebase In App Messaging | 8.10.0 | 8.10.0 |
| Firebase Installations | 8.10.0 | 8.10.0 |
| Firebase Performance Monitoring | 8.10.0 | 8.10.0 |
| Firebase RemoteConfig | 8.10.0 | 8.10.0 |
| Firebase Storage | 8.10.0 | 8.10.0 |
| Google User Messaging Platform | 1.1.0.0 | 8.10.0 |
| Google Cast | 4.7.0.0 | 8.10.0 |
| Google Sign-In | 5.0.2.2 | 8.10.0 |
| Google Tag Manager | 7.4.0.0 | 8.10.0 |
Ad Id Support
By default Firebase includes Ad Id Support, however, it can be disabled by adding the below property group to your project file.
<PropertyGroup>
<FirebaseWithoutAdIdSupport>True</FirebaseWithoutAdIdSupport>
</PropertyGroup>
Building
Prerequisites
Before building the libraries and samples in this repository, you will need to install .NET Core and the Cake .NET Core Tool:
Currently requires a version of Cake less than 1.0 (due to dependencies).
dotnet tool install -g cake.tool --version 0.38.5
When building on macOS, you may also need to install CocoaPods:
# Homebrew
brew install cocoapods
# Ruby Gems
gem install cocoapods
Compiling
You can either build all the libraries and samples in the repository from the root:
dotnet cake
Or, you can specify the components and its dependencies to be build by using the --names=Key1,Key2,...:
// Firebase keys
Firebase.ABTesting
Firebase.AdMob
Firebase.Analytics
Firebase.Auth
Firebase.CloudFirestore
Firebase.CloudFunctions
Firebase.CloudMessaging
Firebase.Core
Firebase.Crashlytics
Firebase.Database
Firebase.DynamicLinks
Firebase.InAppMessaging
Firebase.Installations
Firebase.PerformanceMonitoring
Firebase.RemoteConfig
Firebase.Storage
// Google keys
Google.Analytics
Google.Cast
Google.Maps
Google.MobileAds
Google.UserMessagingPlatform
Google.Places
Google.SignIn
Google.TagManager
// MLKit keys
MLKit.BarcodeScanning
MLKit.Core
MLKit.DigitalInkRecognition
MLKit.FaceDetection
MLKit.ImageLabeling
MLKit.ObjectDetection
MLKit.TextRecognition
MLKit.TextRecognition.Chinese
MLKit.TextRecognition.Devanagari
MLKit.TextRecognition.Japanese
MLKit.TextRecognition.Korean
MLKit.TextRecognition.Latin
MLKit.Vision
The following targets can be specified using the --target=<target-name>:
libsbuilds the class library bindings (depends onexternals)externalsdownloads and builds the external dependenciessamplesbuilds all of the samples (depends onlibs)nugetbuilds the nuget packages (depends onlibs)cleancleans up everything
Working in Visual Studio
Before the .sln files will compile in the IDEs, the external dependencies need to be downloaded. This can be done by running the externals target:
dotnet cake --target=externals
After the externals are downloaded and built, the .sln files should compile in your IDE.
License
The license for this repository is specified in License.md
Contribution Guidelines
You will need to complete a Contribution License Agreement before your pull request can be accepted. You can complete the CLA by going through the steps at https://cla2.dotnetfoundation.org/.
.NET Foundation
This project is part of the .NET Foundation