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/"