Änderungen der Spezifikationsdatei mit generiertem Quellcode synchronisieren

Mit dem Befehl ochain sync können Sie neue Änderungen aus der Spezifikationsdatei in die aktuellen Quelldateien (Modell und Controller) übernehmen. Der Befehl funktioniert sowohl mit TypeScript- als auch mit Go-Projekten.

Hinweis:
  • Die Synchronisierung ist unidirektional: Sie können Änderungen aus Ihrer Spezifikationsdatei in Ihr Chaincode-Projekt bringen, aber nicht umgekehrt. Änderungen an Ihrem Chaincode-Projekt bleiben unverändert nach dem Synchronisierungsprozess.
  • Der Befehl ochain sync funktioniert nur, wenn das Chaincode-Projekt mit einer Spezifikationsdatei erstellt wurde. Löschen, benennen oder verschieben Sie die Spezifikationsdatei nicht, wenn Sie Änderungen aus der Spezifikationsdatei zukünftig mit dem Quellcode synchronisieren möchten.
  • Wenn Sie mehrere Chaincode-Projekte mit einer einzelnen Spezifikationsdatei generiert haben, können Sie jeweils nur ein Projekt mit dem Befehl ochain sync synchronisieren.

Verwendung:

sync [options] [...args]
ochain sync -h 
Usage: sync [options] [...args]
Synchronize Changes from spec file to the required chaincode. 
Arguments:
    [...args] (optional) Sync Arguments.
Options :
    -h, --help              output command usage information
    -D, --debug             enable debug logging
    -p, --project <path>    (optional) Path to Chaincode project to sync. If not specified, it defaults to current directory
    -c, --confirm <bool>    (optional) Parameter to ensure if you have resolved all the conflicts, and commit changes
Examples :
$> ochain sync
without chaincode initial arguments
Der Befehl ochain sync enthält zwei optionale Argumente:
  • -p / --project

    Mit dieser Option wird das Chaincode-Projektverzeichnis synchronisiert. Wenn keine Angabe gemacht wird, wird standardmäßig das aktuelle Verzeichnis verwendet.

  • -c / --confirm

    Bei dieser Option werden boolesche Werte (true/false) verwendet. Wenn beim Zusammenführen Konflikte auftreten, müssen Sie diese Konflikte manuell lösen und diese Option im nächsten Synchronisierungszyklus auf "true" setzen. Verwenden Sie diese Option nicht, wenn Sie nicht sicher sind, ob die Konflikte zusammengeführt wurden.

Wenn der Befehl ochain sync nicht erfolgreich ist und Sie alle Voraussetzungen einschließlich Git und Git-Benutzername und -Kennwort installiert und konfiguriert haben, führen Sie die folgenden Schritte aus, um den Synchronisierungsvorgang erneut zu initialisieren:
  1. Prüfen Sie die Spezifikationsdatei auf Fehler, und beheben Sie alle gefundenen Fehler.
  2. Entfernen Sie im Chaincode-Projektordner die folgenden Ordner, sofern sie vorhanden sind: .sync_temp, .sync_backup und .sync_repo.
  3. Entfernen Sie im Ordner src den Ordner .git, falls dieser vorhanden ist.
  4. Bearbeiten Sie im Root-Ordner des Projekts die Datei ochain.json, und setzen Sie die Eigenschaft syncEnabled auf false. Speichern und schließen Sie die Datei.
  5. Wiederholen Sie den Befehl ochain sync.