Skip to content

Interne Funktionen

Dieser Abschnitt beschreibt einige interne (Test-)Funktionen, die dazu dienen, Probleme zu analysieren.

Wie erhält man die Protokollierungs-Informationen nach einem Absturz?

Es gibt zwei allgemeine Arten von Abstürzen auf dem Gerät, die sich auf Connect beziehen, bei denen in beiden Fällen Protokolldateien generiert werden:

  • App-Abstürze
  • Geräte-Abstürze

App-Abstürze führen normalerweise dazu, dass die App unerwartet beendet wird oder ein 'IQ!'-Symbol angezeigt wird, ohne dass das gesamte Gerät abstürzt oder neu gestartet wird. Dieser Art von Absturz ist meist auf einen Fehler in der App zurückzuführen, kann aber auch auf einen Fehler in Connect IQ selbst beruhen. Bei jedem App-Absturz wird eine CIQ_LOG.YAML-Datei unter /GARMIN/APPS/LOGS auf dem Gerät geschrieben oder aktualisiert und enthält Informationen zum Absturz, die Entwicklern bei der Problembeseitigung helfen können. Hier ist ein typisches CIQ_LOG:


  Error: ErrorName
  Details: Fehlerbeschreibung.
  Time: 2018-02-07T19:07:56Z
  Store-Id: 00000000-0000-0000-0000-000000000000
  Store-Version: 0
  Device-Id: 006-B0000-00
  Device-Version: '0.00'
  ConnectIQ-Version: 3.0.0
  Filename: PRGNAME
  Appname: DemoAppName
  Stack:
    - pc: 0x100000ef
      File: 'C:\Path\To\source\File.mc'
      Line: 53
      Function: function_causing_error
    - pc: 0x10000080
      File: 'C:\Path\To\source\File2.mc'
      Line: 30
      Function: otherBrokenItems

Der Eintrag ConnectIQ-Version bezieht sich nicht auf die Connect IQ-Version des Geräts. Vielmehr handelt es sich um die SDK-Version, die der Entwickler beim Exportieren der Anwendung verwendet hat.

Hinweis:
Für Geräte, die Versionen älter als Connect IQ 3.0 laufen, wird ein vereinfachtes Fehlerprotokoll als CIQ_LOG.TXT ausgegeben.

Geräte-Abstürze führen normalerweise dazu, dass das Gerät neu gestartet oder eingefroren wird. Dies deutet auf einen Fehler in Connect IQ oder dem Geräte-Firmware hin und sollte seltenere Vorkommnisse als App-Abstürze sein. Bei einem Geräte-Absturz wird eine ERR_LOG.txt-Datei unter /GARMIN auf dem Gerät geschrieben, die Stapelverfolgungs-Informationen zum Absturz enthält. Bitte liefern Sie diese Datei bei der Berichterstattung eines Absturzes auf unserem Entwicklerforum mit. Die Garmin-Geräte-Teams können die Geräte-Absturz-Protokolle überprüfen, um den Grund des Absturzes zu ermitteln und werden in der Regel eine Korrektur in einer zukünftigen Firmware-Veröffentlichung bereitstellen.

Wenn eine Protokolldatei 5 kB überschreitet, wird sie automatisch archiviert als .BAK, und ein neues Protokoll wird gestartet. Alle alten .BAK-Dateien werden beim Archivieren überschrieben, sodass das maximale Speicherplatz, das ein Protokoll erreichen kann, etwa 10 kB beträgt.

Hinweis:
Wenn ein App- oder Geräte-Absturz auftritt, liefern Sie uns bitte die erstellten Protokollierungs-Informationen für die Fehleranalyse!

Wie lädt man eine App oder ein Datenfeld per Side-Load auf das Garmin-Gerät?

Bitte führen Sie die folgenden Schritte aus, um eine App oder ein Datenfeld per Side-Load auf Ihr Garmin-Gerät zu laden:

  • Verbinden Sie Ihr Garmin-Gerät über USB mit Ihrem PC/MAC
  • Extrahieren Sie das bereitgestellte ZIP-Datei
  • Kopieren Sie die extrahierte TestApp.prg-Datei in "drive:\GARMIN\APPS"
  • Erstellen Sie eine leere Protokolldatei in "drive:\GARMIN\APPS\LOGS\TestApp.txt"
  • Wenn die Datei "TestApp.txt" bereits existiert, löschen Sie den Inhalt (aber nicht die Datei)
  • Löschen Sie den Inhalt von "drive:\GARMIN\APPS\LOGS\CIQ_LOG.txt" (falls vorhanden)
  • Löschen Sie den Inhalt von "drive:\GARMIN\APPS\LOGS\CIQ_LOG.yaml" (falls vorhanden)
  • Trennen Sie das Garmin-Gerät von USB

Wie testet man eine per Side-Load geladene App oder ein Datenfeld?

Nach dem Laden einer App oder eines Datenfeldes per Side-Load führen Sie bitte die folgenden Schritte aus:

  • Starten Sie die Testanwendung oder das Datenfeld
  • Nachdem das Problem aufgetreten ist, führen Sie die folgenden Schritte aus:
  • Wenn die Uhr neu gestartet wird, warten Sie, bis der Neustart abgeschlossen ist
  • Verbinden Sie Ihr Garmin-Gerät über USB mit Ihrem PC/MAC
  • Fügen Sie die Datei "drive:\GARMIN\APPS\LOGS\TestApp.txt" an die E-Mail an
  • Fügen Sie die Datei "drive:\GARMIN\APPS\LOGS\CIQ_LOG.txt" an die E-Mail an (falls vorhanden)
  • Fügen Sie die Datei "drive:\GARMIN\APPS\LOGS\CIQ_LOG.yaml" an die E-Mail an (falls vorhanden)
  • Trennen Sie das Garmin-Gerät von USB
  • Senden Sie die E-Mail an support@rh-sports.co.at