Skip to content

PerformanceMonitoring.md

Latest commit

 

History

History
59 lines (36 loc) · 2.65 KB

PerformanceMonitoring.md

File metadata and controls

59 lines (36 loc) · 2.65 KB
Raw

AdamE.Firebase.iOS.PerformanceMonitoring

.NET bindings for Firebase Performance Monitoring on Apple platforms.

Scope

Performance collection, trace, metric, HTTP metric, attribute, and instrumentation APIs exposed by the Firebase Apple SDK.

These packages are thin bindings over the native Firebase Apple SDK. The native documentation is the source of truth for product behavior, Firebase console setup, quotas, policy requirements, and feature workflows.

Native Documentation

Package

  • Package ID: AdamE.Firebase.iOS.PerformanceMonitoring
  • Managed namespace: Firebase.PerformanceMonitoring

Supported target frameworks include:

  • net9.0-ios
  • net10.0-ios
  • net9.0-maccatalyst
  • net10.0-maccatalyst

When multi-targeting, condition package references so they restore only for Apple targets:

<ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'ios' Or $([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">
  <PackageReference Include="AdamE.Firebase.iOS.PerformanceMonitoring" Version="x.y.z" />
</ItemGroup>

Installation

dotnet add package AdamE.Firebase.iOS.PerformanceMonitoring

Binding Notes

Use the official Firebase Apple docs for setup and usage. In .NET, call the equivalent APIs from the managed namespace listed above. Keep app-specific Firebase configuration, such as GoogleService-Info.plist, in the application project.

Most Firebase feature packages require AdamE.Firebase.iOS.Core and app startup should call Firebase.Core.App.Configure() before feature APIs are used. This is the .NET binding for native FirebaseApp.configure().

Runtime collection controls are on Firebase.PerformanceMonitoring.Performance.SharedInstance. Set InstrumentationEnabled and DataCollectionEnabled before Firebase.Core.App.Configure() when you need startup-time behavior to change.

Version Alignment

Firebase Apple SDKs are packaged as native xcframeworks. Applications should pin package versions intentionally and keep all AdamE.Firebase.iOS.* packages on the same major/minor Firebase line.

Avoid mixing unrelated Firebase binding package sets or mismatched Firebase native SDK lines in one application. That can cause duplicate symbols, linker failures, runtime loading failures, or undefined native SDK behavior.

Repository