إيقاف مراقبة أداء Firebase

للسماح للمستخدمين بالموافقة على استخدام Firebase Performance Monitoring أو إيقافه، قد تحتاج إلى ضبط إعدادات تطبيقك لتتمكّن من تفعيل Firebase Performance Monitoring وإيقافه.Performance Monitoring وقد تفيدك هذه الميزة أيضًا أثناء تطوير التطبيق واختباره.

في ما يلي بعض الخيارات التي يجب مراعاتها:

يمكنك إيقاف حزمة SDK لنظام التشغيل Performance Monitoring عند إنشاء تطبيقك، مع خيار إعادة تفعيلها في وقت التشغيل.
يمكنك إنشاء تطبيقك مع تفعيل حزمة SDK الخاصة بـ Performance Monitoring، ولكن يمكنك إيقافها في وقت التشغيل باستخدام Firebase Remote Config.
يمكنك إيقاف حزمة SDK الخاصة بـ Performance Monitoring نهائيًا، بدون خيار لتفعيلها في وقت التشغيل.

أوقِف Performance Monitoring أثناء عملية إنشاء تطبيقك.

من الحالات التي قد يكون فيها إيقاف Performance Monitoring أثناء عملية إنشاء التطبيق مفعّلاً هو تجنُّب الإبلاغ عن بيانات الأداء من إصدار ما قبل الإصدار من تطبيقك أثناء تطوير التطبيق واختباره.

لإيقاف Performance Monitoring أو إيقافه، يمكنك إضافة أحد المفتاحَين التاليَين إلىملف قائمة المواقع (Info.plist) لتطبيقك على Apple:

لإيقاف Performance Monitoring، ولكن السماح لتطبيقك بتفعيله أثناء التشغيل، اضبط firebase_performance_collection_enabled على false في ملف Info.plist الخاص بتطبيقك.
لإيقاف Performance Monitoring نهائيًا بدون خيار لتفعيله أثناء التشغيل، اضبط firebase_performance_collection_deactivated على true فيملف Info.plist الخاص بتطبيقك.

ملاحظة: يتجاهل هذا الإعداد الإعداد firebase_performance_collection_enabled ويجب إزالته من ملف Info.plist الخاص بتطبيقك لإعادة تفعيل Performance Monitoring.

إيقاف تطبيقك أثناء التشغيل باستخدام Remote Config

تتيح لك أداة Firebase Remote Config إجراء تغييرات على سلوك تطبيقك ومظهره، لذا فهي توفّر طريقة مثالية لإيقاف Performance Monitoring في مثيلات تطبيقك التي تم نشرها.

لإيقاف جمع بيانات Performance Monitoring في المرة التالية التي يتم فيها تشغيل تطبيق Apple، استخدِم نموذج الرمز البرمجي الموضَّح أدناه. لمزيد من المعلومات عن استخدام Remote Config في أحد تطبيقات Apple، يُرجى الاطّلاع على مقالة استخدام Firebase Remote Config على منصات Apple.

تأكَّد من استخدام Remote Config في Podfile:
```
pod 'Firebase/RemoteConfig'
```
أضِف ما يلي إلى أعلى ملف AppDelegate في تطبيقك:
Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.
```
import FirebaseRemoteConfig
```
Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.
```
@import FirebaseRemoteConfig;
```

في ملف AppDelegate، أضِف الرمز البرمجي التالي إلى launchOptions العبارة في application:didFinishLaunchingWithOptions: مثيل الطريقة:

Swift

ملاحظة: لا يتوفّر هذا المنتج على أجهزة macOS وMac Catalyst وwatchOS.

remoteConfig = RemoteConfig.remoteConfig()
// You can change the "false" below to "true" to permit more fetches when validating
// your app, but you should change it back to "false" or remove this statement before
// distributing your app in production.
let remoteConfigSettings = RemoteConfigSettings(developerModeEnabled: false)
remoteConfig.configSettings = remoteConfigSettings!
// Load in-app defaults from a plist file that sets perf_disable to false until
// you update values in the Firebase console.
remoteConfig.setDefaultsFromPlistFileName("RemoteConfigDefaults")
// Important! This needs to be applied before FirebaseApp.configure()
if !remoteConfig["perf_disable"].boolValue {
    // The following line disables all automatic (out-of-the-box) monitoring
    Performance.sharedInstance().isInstrumentationEnabled = false
    // The following line disables all custom monitoring
    Performance.sharedInstance().isDataCollectionEnabled = false
}
else {
    Performance.sharedInstance().isInstrumentationEnabled = true
    Performance.sharedInstance().isDataCollectionEnabled = true
}
// Use Firebase library to configure APIs
FirebaseApp.configure()

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.

self.remoteConfig = [FIRRemoteConfig remoteConfig];
// You can change the NO below to YES to permit more fetches when validating
// your app, but you should change it back to NO or remove this statement before
// distributing your app in production.
FIRRemoteConfigSettings *remoteConfigSettings =
    [[FIRRemoteConfigSettings alloc] initWithDeveloperModeEnabled:NO];
self.remoteConfig.configSettings = remoteConfigSettings;
// Load in-app defaults from a plist file that sets perf_disable to false until
// you update values in the Firebase console.
[self.remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"];
// Important! This needs to be applied before [FIRApp configure]
if (!self.remoteConfig[@"perf_disable"].numberValue.boolValue) {
    // The following line disables all automatic (out-of-the-box) monitoring
    [FIRPerformance sharedInstance].instrumentationEnabled = NO;
    // The following line disables all custom monitoring
    [FIRPerformance sharedInstance].dataCollectionEnabled = NO;
}
else {
    [FIRPerformance sharedInstance].instrumentationEnabled = YES;
    [FIRPerformance sharedInstance].dataCollectionEnabled = YES;
}
// Use Firebase library to configure APIs
[FIRApp configure];

في ViewController.m أو ملف تنفيذ آخر يستخدمه تطبيقك، أضِف الرمز التالي للحصول على قيم Remote Config وتفعيلها:

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.

//RemoteConfig fetch and activation in your app, shortly after startup
remoteConfig.fetch(withExpirationDuration: TimeInterval(30.0)) { (status, error) -> Void in
  if status == .success {
    print("Config fetched!")
    self.remoteConfig.activateFetched()
  } else {
    print("Config not fetched")
    print("Error \(error!.localizedDescription)")
  }
}

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.

//RemoteConfig fetch and activation in your app, shortly after startup
[self.remoteConfig fetchWithExpirationDuration:30.0 completionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
  if (status == FIRRemoteConfigFetchStatusSuccess) {
    NSLog(@"Config fetched!");
    [self.remoteConfig activateFetched];
  } else {
    NSLog(@"Config not fetched");
    NSLog(@"Error %@", error.localizedDescription);
  }
}];

لإيقاف Performance Monitoring في وحدة تحكّم Firebase، أنشئ مَعلمة perf_disable في مشروع تطبيقك، ثم اضبط قيمتها على true.

إذا ضبطت قيمة perf_disable على false، سيظل الخيار Performance Monitoring مفعّلاً.

إيقاف جمع البيانات التلقائي أو المخصّص بشكل منفصل

يمكنك إجراء بعض التغييرات على الرمز المعروض أعلاه وفي وحدة تحكّم Firebase للسماح لك بإيقاف جميع عمليات المراقبة التلقائية (التلقائية) بشكل منفصل عن المراقبة المخصّصة.

أضِف الرمز البرمجي التالي إلى عبارات launchOptions في application:didFinishLaunchingWithOptions:method (بدلاً مما هو معروض أعلاه لطريقة المثيل نفسها):

Swift

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.

remoteConfig = FIRRemoteConfig.remoteConfig()
let remoteConfigSettings = FIRRemoteConfigSettings(developerModeEnabled: true)
remoteConfig.configSettings = remoteConfigSettings!
// Important! This needs to be applied before FirebaseApp.configure()
if remoteConfig["perf_disable_auto"].boolValue {
    // The following line disables all automatic (out-of-the-box) monitoring
    Performance.sharedInstance().isInstrumentationEnabled = false
}
else {
    Performance.sharedInstance().isInstrumentationEnabled = true
}
if remoteConfig["perf_disable_manual"].boolValue {
    // The following line disables all custom monitoring
    Performance.sharedInstance().isDataCollectionEnabled = false
}
else {
    Performance.sharedInstance().isDataCollectionEnabled = true
}
// Use Firebase library to configure APIs
FirebaseApp.configure()

Objective-C

ملاحظة: لا يتوفّر منتج Firebase هذا على استهدافات macOS وMac Catalyst وwatchOS.

self.remoteConfig = [FIRRemoteConfig remoteConfig];
FIRRemoteConfigSettings *remoteConfigSettings =
    [[FIRRemoteConfigSettings alloc] initWithDeveloperModeEnabled:YES];
self.remoteConfig.configSettings = remoteConfigSettings;
// Important! This needs to be applied before [FirebaseApp configure]
if (self.remoteConfig[@"perf_disable_auto"].numberValue.boolValue) {
    // The following line disables all automatic (out-of-the-box) monitoring
    [FIRPerformance sharedInstance].instrumentationEnabled = NO;
}
else {
    [FIRPerformance sharedInstance].instrumentationEnabled = YES;
}
if (self.remoteConfig[@"perf_disable_manual"].numberValue.boolValue) {
    // The following line disables all custom monitoring
    [FIRPerformance sharedInstance].dataCollectionEnabled = NO;
}
else {
    [FIRPerformance sharedInstance].dataCollectionEnabled = YES;
}
// Use Firebase library to configure APIs
[FirebaseApp configure];

أكمِل ما يلي في وحدة تحكّم Firebase:
- لإيقاف جميع عمليات المراقبة التلقائية (التلقائية)، أنشئ مَعلمة perf_disable_auto في مشروع تطبيقك، ثم اضبط قيمة على true.
- لإيقاف جميع عمليات المراقبة المخصّصة، أنشئ مَعلمة perf_disable_manual في مشروع تطبيقك، ثم اضبط قيمتها على true.
ملاحظة: لتفعيل أيّ من هذين الجانبَين من Performance Monitoring في تطبيقك، اضبط قيمة المَعلمة المقابلة على false في وحدة تحكّم Firebase.