flash_rollbar

Aufmerksamkeit:

Ab Mai 2024 wird Rollbar dieses Repository nicht aktiv aktualisieren und plant, ihn im Januar 2025 zu archivieren. Wir ermutigen unsere Community, dieses Repo zu forkieren, wenn Sie seine Entwicklung fortsetzen möchten. Während Rollbar keine aktive Entwicklung mehr beteiligen wird, bleiben wir weiterhin für die Überprüfung und Zusammenführung von Pull -Anfragen im Zusammenhang mit Sicherheitsupdates verpflichtet. Wenn eine aktiv gepflegte Gabel entsteht, wenden Sie sich bitte an unser Support -Team und wir werden aus unserer Dokumentation darauf verlinken.

Rollbar -Notifier für Flash (AS3)

Flash (ActionScript 3) Bibliothek zur Berichterstattung über Ausnahmen, Fehler und Protokollnachrichten bei Rollbar.

Schneller Start

1. Laden Sie den Code von Flash_Rollbar oder nur die Datei rollbar.swc herunter.
2. Platzieren Sie das Verzeichnis flash_rollbar/src in Ihren Quellpfad oder platzieren Sie die Datei Rollbar.swc in den Bibliotheksweg Ihres Projekts.
3. Rollbar.init(this, accessToken, environment); Aus Ihrem obersten 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() hat einen globalen Fehlerhandler installiert, sodass Sie nichts anderes tun müssen.

Stellen Sie sicher, dass Sie POST_CLIENT_ITEM_ACCESS_TOKEN durch das post_client_item Access -Token Ihres Projekts ersetzen, das Sie in der Schnittstelle rollbar.com finden können.

Anforderungen

• Flash Player 10.1+
  • Kann an 9 funktionieren, aber nicht getestet.
• MXMLC/COMPC, wenn Sie vorhaben, aus der Befehlszeile zu bauen
• Ein Rollbar -Konto

Berichterstattung erfasste Fehler

Wenn Sie bestimmte Teile Ihres Codes instrumentieren möchten, rufen Sie Rollbar.handleError(err) auf:

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

Erweitert: Um Teile der Nutzlast zu überschreiben, bevor sie an die Rollbar -API gesendet wird, übergeben Sie sie im zweiten Argument an handleError() . Um beispielsweise zu steuern, wie Ihre Daten gruppiert werden, können Sie einen benutzerdefinierten fingerprint übergeben:

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

Das zweite Argument, extraData , sollte ein Objekt sein. Jeder Schlüssel in extraData überschreibt den vorherigen Inhalt der Nutzlast. Für alle Optionen finden Sie in der API -Dokumentation.

Konfiguration

In der obersten Ebene Ihrer Anzeigeliste instanziieren Sie das Rollbar -Singleton.

Rollbar . init ( this , accessToken, environment) ;

Hier ist die vollständige Liste der Konstruktorparameter (in der Reihenfolge):

Elternteil

Der übergeordnete Display -Objektcontainer; sollte normalerweise "` `this``` sein. Der Notifier meldet alle Fehler für SWFs, die mit `` übergeordnet sind.

AccessToken

Zugriff auf Token aus Ihrem Rollbar -Projekt

Umfeld

Umgebungsname. Jede Zeichenfolge bis zu 255 Zeichen ist in Ordnung. Verwenden Sie für die besten Ergebnisse "" "Produktion" "" "" "für Ihre Produktionsumgebung.

Standard: "production"

Person

Optional, kann aber einer von: sein:

• Eine Zeichenfolgekennung für die aktuelle Person/den aktuellen Benutzer.
• Ein Objekt, das die aktuelle Person/den aktuellen Benutzer beschreibt, das enthält
  • Erforderlich - ID, userId, user_id, user
  • Optional - E -Mail, useremail, user_email, E -MailAddress, E -Mail_address
  • Optional - Benutzername, Benutzername, user_name, Name
• Eine Funktion, die ein Objekt wie das oben beschriebene zurückgibt

Wurzelweg

Wenn Sie die SWC/SWF mit den Debug- oder ausführlichen Stapel -Trace -Flags zusammengestellt haben, möchten Sie, dass dies der absolute Weg zum Stammverschluss Ihres ActionScript -Quellcode ist, ohne das endgültige "` `/` `` `.

Legen Sie dies ansonsten auf den Quellpfad relativ zum Stamm Ihres Repositorys ein. ZB, wenn Ihr Quellbaum so aussieht:

 /myApp/src/com/myApp

Stellen Sie dies auf "src" ein

Codebranch

Name des Zweigs, der verwendet wird, um Ihren Flash -Film zu kompilieren.

Standard: "master"

ServerData

Ein Objekt, das alle Daten enthält, die Sie mit diesem Artikel übergeben möchten, um zu speichern.

MaxItemcount

Die maximale Anzahl von Elementen, die für die Lebensdauer der Notifier -Instanz an Rollbar gesendet werden müssen. Dies ist nützlich, um die Anzahl der an Rollbar gesendeten Elemente zu beschränken.

Endpointurl

URL -Artikel werden an gesendet.

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