flash_rollbar

Attention:

En mai 2024, Rollbar ne mettra pas activement à jour ce référentiel et prévoit de l'archiver en janvier 2025. Nous encourageons notre communauté à débarrasser ce référentiel si vous souhaitez poursuivre son développement. Bien que Rollbar ne s'engage plus dans un développement actif, nous restons déterminés à examiner et à fusionner les demandes de traction liées aux mises à jour de sécurité. Si une fourchette activement entretenue émerge, veuillez contacter notre équipe d'assistance et nous nous lierons à partir de notre documentation.

Rollbar Notifier pour Flash (AS3)

Flash (ActionScript 3) Bibliothèque pour signaler les exceptions, les erreurs et les messages de journal à Rollbar.

Démarrage rapide

1. Téléchargez le code flash_rollbar ou simplement le fichier rollbar.swc.
2. Placez le répertoire flash_rollbar/src dans votre chemin source ou placez le fichier Rollbar.swc sur le chemin de la bibliothèque de votre projet.
3. Appelez Rollbar.init(this, accessToken, environment); de votre DisplayObject de niveau supérieur.

 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() a installé un gestionnaire d'erreurs global, vous n'avez donc pas besoin de faire autre chose.

Assurez-vous de remplacer POST_CLIENT_ITEM_ACCESS_TOKEN avec le jeton d'accès post_client_item de votre projet, que vous pouvez trouver dans l'interface rollbar.com.

Exigences

• Flash Player 10.1+
  • Peut fonctionner sur 9, mais pas testé.
• MXMLC / COMPC Si vous prévoyez de construire à partir de la ligne de commande
• Un compte Rollbar

Rapport des erreurs capturées

Si vous souhaitez instrument des parties spécifiques de votre code, appelez Rollbar.handleError(err) :

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

Avancé: Pour remplacer les parties de la charge utile avant d'être envoyée à l'API Rollbar, passez-les dans le deuxième argument à handleError() . Par exemple, pour contrôler la façon dont vos données seront regroupées, vous pouvez passer une fingerprint personnalisée:

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

Le deuxième argument, extraData , devrait être un objet. Chaque clé d' extraData écrasera le contenu précédent de la charge utile. Pour toutes les options, consultez la documentation de l'API.

Configuration

Au niveau le plus supérieur de votre liste d'affichage, instanciez le Singleton Rollbar.

Rollbar . init ( this , accessToken, environment) ;

Voici la liste complète des paramètres du constructeur (dans l'ordre):

mère

Le conteneur d'objet d'affichage parent; devrait généralement être `` `` ceci ''. Le notificateur rapportera toutes les erreurs pour SWFS chargées de `` `` parent.loadeRenfo ''.

accéder à

Jeton d'accès à partir de votre projet Rollbar

environnement

Nom de l'environnement. Toute chaîne jusqu'à 255 caractères est OK. Pour de meilleurs résultats, utilisez `` `` «production» `` pour votre environnement de production.

Par défaut: "production"

personne

Facultatif mais peut être l'un des:

• Un identifiant de chaîne pour la personne / utilisateur actuel.
• Un objet décrivant la personne / utilisateur actuel, contenant
  • Requis - id, userId, user_id, utilisateur
  • Facultatif - Email, Usemail, user_email, emailAddress, email_address
  • Facultatif - nom d'utilisateur, nom d'utilisateur, user_name, nom
• Une fonction renvoyant un objet comme celui décrit ci-dessus

passe-root

Si vous avez compilé le SWC / SWF à l'aide des indicateurs de trace de pile de débogage ou verbeux, vous voudrez que ce soit le chemin absolu vers la racine de votre code source ActionScript, sans compter le `` `` / '' '.

Sinon, définissez-le sur le chemin source par rapport à la racine de votre référentiel. Par exemple, si votre arbre source ressemble à ceci:

 /myApp/src/com/myApp

Réglez ceci sur "src"

codebanch

Nom de la branche utilisée pour compiler votre film flash.

Par défaut: "master"

serverdata

Un objet contenant toutes les données que vous souhaitez transmettre avec cet élément pour stocker.

maxitemcount

Le nombre maximum d'articles à envoyer à Rollbar pour la durée de vie de l'instance de notificateur. Ceci est utile pour limiter le nombre d'éléments envoyés à Rollbar.

endpointurl

Les articles d'URL sont affichés.

Par défaut: "https://api.rollbar.com/api/1/item/"