flash_rollbar

Perhatian:

Pada Mei 2024, Rollbar tidak akan secara aktif memperbarui repositori ini dan berencana untuk mengarsipkannya pada bulan Januari 2025. Kami mendorong komunitas kami untuk membayar repo ini jika Anda ingin melanjutkan pengembangannya. Meskipun Rollbar tidak akan lagi terlibat dalam pengembangan aktif, kami tetap berkomitmen untuk meninjau dan menggabungkan permintaan tarik terkait dengan pembaruan keamanan. Jika garpu yang dipelihara secara aktif muncul, silakan hubungi tim dukungan kami dan kami akan menautkannya dari dokumentasi kami.

Pemberitahuan Rollbar untuk Flash (AS3)

Flash (ActionScript 3) Perpustakaan untuk melaporkan pengecualian, kesalahan, dan pesan log ke Rollbar.

Awal yang cepat

1. Unduh kode flash_rollbar atau hanya file rollbar.swc.
2. Tempatkan direktori flash_rollbar/src di jalur sumber Anda atau letakkan file Rollbar.swc di jalur perpustakaan proyek Anda.
3. Hubungi Rollbar.init(this, accessToken, environment); dari DisplayObject Anda tingkat atas.

 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() menginstal penangan kesalahan global, jadi Anda tidak perlu melakukan hal lain.

Pastikan untuk mengganti POST_CLIENT_ITEM_ACCESS_TOKEN dengan token akses post_client_item proyek Anda, yang dapat Anda temukan di antarmuka Rollbar.com.

Persyaratan

• Flash Player 10.1+
  • Dapat bekerja pada 9, tetapi tidak diuji.
• MXMLC/COMPC Jika Anda berencana membangun dari baris perintah
• Akun rollbar

Melaporkan kesalahan yang tertangkap

Jika Anda ingin instrumen bagian tertentu dari kode Anda, hubungi Rollbar.handleError(err) :

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

Advanced: Untuk mengganti bagian muatan sebelum dikirim ke Rollbar API, lewati mereka dalam argumen kedua ke handleError() . Misalnya, untuk mengontrol bagaimana data Anda akan dikelompokkan, Anda dapat melewati fingerprint khusus:

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

Argumen kedua, extraData , harus menjadi objek. Setiap kunci dalam extraData akan menimpa konten muatan sebelumnya. Untuk semua opsi, lihat dokumentasi API.

Konfigurasi

Di tingkat teratas daftar tampilan Anda, instantiate rollbar singleton.

Rollbar . init ( this , accessToken, environment) ;

Berikut daftar lengkap parameter konstruktor (secara berurutan):

induk

Wadah objek tampilan induk; biasanya harus `` `ini```. Pemberitahuan akan melaporkan semua kesalahan untuk SWF yang dimuat dengan `` `Parent.LoaderInfo```.

AccessToken

Akses token dari proyek rollbar Anda

lingkungan

Nama Lingkungan. Setiap string hingga 255 chars baik -baik saja. Untuk hasil terbaik, gunakan `` `" "Produksi" `` `untuk lingkungan produksi Anda.

Default: "production"

orang

Opsional tetapi bisa menjadi salah satu dari:

• Pengidentifikasi string untuk orang/pengguna saat ini.
• Objek yang menggambarkan orang/pengguna saat ini, berisi
  • Diperlukan - ID, userid, user_id, pengguna
  • Opsional - Email, useremail, user_email, emailAddress, email_address
  • Opsional - Nama pengguna, nama pengguna, user_name, nama
• Fungsi mengembalikan objek seperti yang dijelaskan di atas

Rootpath

Jika Anda menyusun SWC/SWF menggunakan bendera Debug atau Verbose Stack Trace, Anda ingin ini menjadi jalur absolut ke akar kode sumber ActionScript Anda, tidak termasuk ``/`` `` `.

Jika tidak, atur ini ke jalur sumber relatif terhadap root repositori Anda. misalnya jika pohon sumber Anda terlihat seperti ini:

 /myApp/src/com/myApp

Atur ini ke "src"

Codebranch

Nama cabang yang digunakan untuk mengkompilasi film flash Anda.

Default: "master"

serverData

Objek yang berisi data apa pun yang ingin Anda sampaikan dengan item ini untuk disimpan.

MaxItemCount

Jumlah maksimum item yang akan dikirim ke Rollbar untuk seumur hidup instance pemberi notifier. Ini berguna untuk membatasi tingkat jumlah item yang dikirim ke Rollbar.

endpointurl

Item URL diposting ke.

Default: "https://api.rollbar.com/api/1/item/"