flash_rollbar

انتباه:

اعتبارًا من مايو 2024 ، لن تقوم Rollbar بتحديث هذا المستودع بنشاط ويعتزم أرشفةه في يناير من عام 2025. نشجع مجتمعنا على توتر هذا الريبو إذا كنت ترغب في مواصلة تطوره. على الرغم من أن Rollbar لن يشارك في التطوير النشط ، إلا أننا نظل ملتزمين بمراجعة ودمج طلبات السحب المتعلقة بتحديثات الأمان. إذا ظهرت شوكة تم الحفاظ عليها بنشاط ، فيرجى التواصل مع فريق الدعم الخاص بنا وسنرتبط به من وثائقنا.

Rollbar Sotfier flash (AS3)

Flash (ActionScript 3) مكتبة للإبلاغ عن استثناءات وأخطاء ورسائل تسجيل إلى Rollbar.

بداية سريعة

1. قم بتنزيل رمز Flash_rollbar أو ملف Rollbar.swc فقط.
2. ضع دليل flash_rollbar/src في مسار المصدر الخاص بك أو ضع ملف Rollbar.swc في مسار مكتبة مشروعك.
3. استدعاء Rollbar.init(this, accessToken, environment); من DisplayObject من المستوى الأعلى.

 package {
  import com.rollbar.notifier.Rollbar ;

  public class MyApp extends Sprite {

    public static const ROLLBAR_ACCESS_TOKEN : String = "POST_CLIENT_ITEM_ACCESS_TOKEN" ;

    public function MyApp () {
      var environment : String = isDebug () ? "development" : "production" ;
      var person : Object = { id : getUserId(), email : getEmail(), name : getName()} ;  // optional
      Rollbar . init ( this , ROLLBAR_ACCESS_TOKEN , environment, person) ;
    }
  }
}

قام Rollbar.init() بتثبيت معالج أخطاء عالمي ، لذلك لا تحتاج إلى فعل أي شيء آخر.

تأكد من استبدال POST_CLIENT_ITEM_ACCESS_TOKEN برمز الوصول إلى مشروع post_client_item لمشروعك ، والذي يمكنك العثور عليه في واجهة Rollbar.com.

متطلبات

• Flash Player 10.1+
  • قد تعمل على 9 ، ولكن لم يتم اختبارها.
• MXMLC/COMPC إذا كنت تخطط للبناء من سطر الأوامر
• حساب Rollbar

التقارير التي اشتعلت أخطاء

إذا كنت ترغب في أداة معينة من الكود الخاص بك ، اتصل بـ Rollbar.handleError(err) :

 private function onEnterFrame(event : Event ) {
    try {
      gameLoop(event) ;
    } catch (err:Error) {
      Rollbar . handleError(err) ;
    }
}

متقدم: لتجاوز أجزاء الحمولة الصافية قبل إرسالها إلى API Rollbar ، تمريرها في الوسيطة الثانية إلى handleError() . على سبيل المثال ، للتحكم في كيفية تجميع بياناتك ، يمكنك تمرير fingerprint مخصصة:

Rollbar . handleError(err, {fingerprint: "a string to uniquely identify this error" }) ;

الوسيطة الثانية ، extraData ، يجب أن تكون كائن. سيقوم كل مفتاح في extraData بكتابة محتويات الحمولة السابقة. للحصول على جميع الخيارات ، راجع وثائق API.

إعدادات

في أعلى مستوى قائمة العرض الخاصة بك ، قم بتثبيت Rollbar Singleton.

Rollbar . init ( this , accessToken, environment) ;

إليك القائمة الكاملة لمعلمات المنشئ (بالترتيب):

الوالد

حاوية كائن العرض الأصل ؛ يجب أن يكون عادة "هذا" ". ستقوم الإعلام بالإبلاغ عن جميع الأخطاء لـ SWFs التي يتم تحميلها بـ `` `barent.loaderInfo```.

AccessToken

الرمز المميز للوصول من مشروع Rollbar الخاص بك

بيئة

اسم البيئة. أي سلسلة تصل إلى 255 chars على ما يرام. للحصول على أفضل النتائج ، استخدم "الإنتاج" "لبيئة الإنتاج الخاصة بك.

الافتراضي: "production"

شخص

اختياري ولكن يمكن أن يكون واحد من:

• معرف سلسلة للشخص/المستخدم الحالي.
• كائن يصف الشخص/المستخدم الحالي ، الذي يحتوي
  • مطلوب - معرف ، userId ، user_id ، المستخدم
  • اختياري - البريد الإلكتروني ، useremail ، user_email ، emailaddress ، email_address
  • اختياري - اسم المستخدم ، اسم المستخدم ، user_name ، الاسم
• وظيفة إرجاع كائن مثل تلك الموصوفة أعلاه

جذر

إذا قمت بتجميع SWC/SWF باستخدام أعلام تتبع Debug أو Ferbose ، فستحتاج إلى أن يكون هذا هو المسار المطلق لجذر رمز مصدر ActionScript الخاص بك ، وليس بما في ذلك `` `/` `` ``.

خلاف ذلك ، اضبط هذا على مسار المصدر بالنسبة إلى جذر مستودعك. على سبيل المثال ، إذا كانت شجرة المصدر تبدو هكذا:

 /myApp/src/com/myApp

اضبط هذا على "src"

Codebranch

اسم الفرع المستخدم لتجميع فيلم الفلاش الخاص بك.

الافتراضي: "master"

ServerData

كائن يحتوي على أي بيانات ترغب في تمريرها مع هذا العنصر لتخزينها.

MaxItemCount

الحد الأقصى لعدد العناصر التي يجب إرسالها إلى Rollbar لعمر مثيل Sotfier. هذا مفيد في الحد من معدل العناصر المرسلة إلى Rollbar.

Endpointurl

يتم نشر عناصر URL على.

الافتراضي: "https://api.rollbar.com/api/1/item/"