flash_rollbar

Atenção:

Em maio de 2024, a Rollbar não atualizará ativamente esse repositório e planeja arquivá -lo em janeiro de 2025. Incentivamos nossa comunidade a gastar este repositório, se você deseja continuar seu desenvolvimento. Embora a Rollbar não esteja mais envolvida no desenvolvimento ativo, continuamos comprometidos em revisar e mesclar solicitações de puxar relacionadas às atualizações de segurança. Se um garfo mantido ativamente surgir, entre em contato com a nossa equipe de suporte e nós o vincularemos a ele a partir de nossa documentação.

Notificador de Rollbar para Flash (AS3)

Flash (ActionScript 3) Biblioteca para relatar exceções, erros e mensagens de log na barra de roll.

Início rápido

1. Faça o download do código flash_rollbar ou apenas o arquivo rollbar.swc.
2. Coloque o diretório flash_rollbar/src no caminho de origem ou coloque o arquivo Rollbar.swc no caminho da biblioteca do seu projeto.
3. Call Rollbar.init(this, accessToken, environment); do seu DisplayObject de nível superior.

 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() instalou um manipulador de erros global, para que você não precise fazer mais nada.

Certifique -se de substituir POST_CLIENT_ITEM_ACCESS_TOKEN pelo token de acesso post_client_item do seu projeto, que você pode encontrar na interface rollbar.com.

Requisitos

• Flash Player 10.1+
  • Pode funcionar em 9, mas não testado.
• MXMLC/COMPC Se você planeja construir a partir da linha de comando
• Uma conta Rollbar

Relatar erros captados

Se você deseja instrumentar partes específicas do seu código, ligue para Rollbar.handleError(err) :

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

Avançado: para substituir partes da carga útil antes de ser enviada para a API da barra de roll, passe -as no segundo argumento para handleError() . Por exemplo, para controlar como seus dados serão agrupados, você pode passar por uma fingerprint personalizada:

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

O segundo argumento, extraData , deve ser um objeto. Cada chave em extraData substituirá o conteúdo anterior da carga útil. Para todas as opções, consulte a documentação da API.

Configuração

No nível superior da sua lista de exibição, instancie o rollbar singleton.

Rollbar . init ( this , accessToken, environment) ;

Aqui está a lista completa dos parâmetros do construtor (em ordem):

pai

O contêiner de objeto de exibição pai; geralmente deve ser `` `this`` '. O notificador reportará todos os erros para SWFs carregados com `` parent.loaderinfo``.

AccessToken

Acesso token do seu projeto RollBar

ambiente

Nome do ambiente. Qualquer string de até 255 chars está ok. Para obter melhores resultados, use `` `" Produção "` `para o seu ambiente de produção.

Padrão: "production"

pessoa

Opcional, mas pode ser um de:

• Um identificador de string para a pessoa/usuário atual.
• Um objeto que descreve a pessoa/usuário atual, contendo
  • Necessário - ID, UserID, User_id, Usuário
  • Opcional - email, correio de usuário, user_email, e -mailddress, e -mail_address
  • Opcional - nome de usuário, nome de usuário, user_name, nome
• Uma função retornando um objeto como o descrito acima

rootpath

Se você compilou o SWC/SWF usando os sinalizadores de rastreamento de depuração ou pilha detalhada, desejará que este seja o caminho absoluto para a raiz do seu código -fonte do ActionScript, sem incluir o final `` `/` `` `.

Caso contrário, defina isso no caminho da origem em relação à raiz do seu repositório. por exemplo, se sua árvore de origem se parece com o seguinte:

 /myApp/src/com/myApp

Defina isso como "src"

CodeBranch

Nome da filial usada para compilar seu filme Flash.

Padrão: "master"

servidordata

Um objeto que contém todos os dados que você deseja transmitir junto com este item para armazenar.

MaxItemCount

O número máximo de itens a serem enviados para a barra de roll para a vida útil da instância do notificador. Isso é útil para limitar a taxa do número de itens enviados para a barra de roll.

endpointurl

Itens de URL são postados para.

Padrão: "https://api.rollbar.com/api/1/item/"