flash_rollbar

注意力：

截至2024年5月，Rollbar將不會積極地更新此存儲庫，併計劃在2025年1月進行存檔。如果您希望繼續開發，我們鼓勵我們的社區分叉此倉庫。儘管Rollbar將不再從事積極的開發，但我們仍致力於審查和合併與安全更新有關的拉動請求。如果出現了積極維護的叉子，請與我們的支持團隊聯繫，我們將從文檔中鏈接到它。

Flash的Rollbar Notifier（AS3）

Flash（ActionScript 3）庫，用於報告異常，錯誤和日誌消息。

快速開始

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) ;
    }
}

高級：要覆蓋有效載荷的一部分，然後將其發送到Rollbar API，請在第二個參數中將其傳遞給handleError() 。例如，要控制數據將如何分組，您可以通過自定義fingerprint ：

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

第二個參數， extraData應該是一個對象。 extraData中的每個鍵將覆蓋有效載荷的先前內容。有關所有選項，請參見API文檔。

配置

在顯示列表的最高級別，實例化Rollbar Singleton。

Rollbar . init ( this , accessToken, environment) ;

這是構造函數參數的完整列表（按順序）：

父母

父顯示對象容器；通常應該是``這個''。通知器將報告帶有``​​parent.loaderinfo'''的SWF的所有錯誤。

訪問

從您的Rollbar項目中訪問令牌

環境

環境名稱。任何高達255個字符的字符串都是可以的。為了獲得最佳效果，請使用````生產''`````''

默認： "production"

人

可選，但可以是：

• 當前人員/用戶的字符串標識符。
• 描述當前人員/用戶的對象，包含
  • 必需-ID，userId，user_id，用戶
  • 可選 - 電子郵件，用戶郵件，user_email，emailaddress，email_address
  • 可選 - 用戶名，用戶名，user_name，名稱
• 像上述對像一樣返回對象的功能

rootpath

如果您使用調試或詳細堆棧跟踪標誌對SWC/SWF進行了編譯，則您將希望這是通往Actionscript源代碼根的絕對路徑，而不包括最終``/````````''。

否則，將其設置為相對於存儲庫的根的源路徑。例如，如果您的源樹看起來像這樣：

 /myApp/src/com/myApp

將此設置為"src"

CodeBranch

用於編譯Flash電影的分支的名稱。

默認： "master"

ServerData

一個包含您想要傳遞的數據的對象，並將其與此商品一起存儲。

Maxitemcount

在Notifier實例的使用壽命中，要發送到Rollbar的最大項目數量。這對於限制了發送到Rollbar的項目數量很有用。

端點

URL項目已發佈到。

默認值： "https://api.rollbar.com/api/1/item/"