Bearbeiten von Add-Ins

Bearbeiten von Add-Ins

Es ist häufig erforderlich, Add-Ins zu bearbeiten, um Verbesserungen vorzunehmen oder neue Funktionen hinzuzufügen.

In diesem Thema wird das Bearbeiten eines Add-Ins erläutert.

Schritte:

1. Vergewissern Sie sich, dass das anfängliche Add-In-Projekt funktioniert.

   Vorausgesetzt, dass Sie bereits ein Add-In-Projekt erstellt haben, ist dieser Schritt möglicherweise redundant. Er kann sich jedoch als hilfreich erweisen, wenn zwischen der ersten Version und der geplanten Aktualisierung einige Zeit vergangen ist. Darüber hinaus erhalten Sie durch das Testen der Funktionsweise eine Basis für die weiteren Änderungen. Hier finden Sie einige Hinweise zu diesem Schritt im Prozess:

   • Testen Sie das Add-In auf einem Rechner mit denselben Arbeitsabläufen, die von den Benutzern des Add-Ins verwendet werden.
   • Sichern Sie das vorhandene Add-In-Projekt, falls Sie die Änderungen rückgängig machen müssen.
   • Falls Fehler in der aktuellen Version des Add-Ins vorhanden sind, stellen Sie sicher, dass Sie diese in Ihrer Entwicklungsumgebung reproduzieren können.
     Hinweis:

     Beheben Sie den Fehler erst dann, wenn Sie eine Sicherungskopie erstellt haben.

2. Nehmen Sie Verbesserungen vor oder fügen Sie neue Funktionen hinzu.

   Nachdem Sie eine Sicherungskopie des Add-In-Projekts erstellt haben, können Sie die Änderungen vornehmen:

   1. Nehmen Sie Änderungen an den Projekteinstellungen oder dem Inhalt des Add-Ins vor.
      • Wenn Sie die Einstellungen wie Beschreibung, Bild oder Version aktualisieren möchten, starten Sie den Python Add-In-Assistenten, und navigieren Sie zum vorhandenen Projektordner (nicht zur Sicherungskopie).
        Hinweis:

        Sie werden in einer Meldung informiert, dass eine Sicherungskopie des vorhandenen Python-Skripts gespeichert wurde und ein neues Quellskript erstellt wird, wenn Sie die Änderungen speichern. Das Sicherungsskript ist erforderlich, da nicht absehbar ist, ob neue Add-In-Typen (z. B. eine Schaltfläche) erstellt werden.

      • Wenn Sie Änderungen vornehmen, die sich nicht auf das Python-Skript auswirken, löschen Sie das neu erstellte Skript aus dem Arbeitsordner, und benennen Sie das Sicherungsskript wieder in den ursprünglichen Namen um.
      • Wenn neue Add-In-Typen hinzugefügt oder Änderungen an Klassennamen vorgenommen werden, kopieren Sie bei Bedarf den Code aus dem Sicherungsskript in das neu erstellte Skript.
   2. Nehmen Sie Änderungen am Python-Skript vor.
      • Wenn Sie nur Funktionen im vorhandenen Add-In-Skript aktualisieren und hinzufügen möchten, brauchen Sie den Python Add-In-Assistenten nicht zu öffnen. Nehmen Sie einfach die erforderlichen Änderungen im Python-Skript vor, und speichern Sie es.
        Hinweis:

        Benennen Sie nicht die Klasse im Skript um. Der Klassenname wird in der Datei config.xml referenziert. Wenn Sie den Namen im Skript ändern, müssen Sie die Datei config.xml anpassen.

3. Testen Sie die Bearbeitungen.

   Nachdem Sie die Bearbeitungen vorgenommen haben, müssen Sie die Add-In-Datei neu erstellen und das Add-In testen, bevor Sie es freigeben. Eine Anleitung dazu finden Sie unter Testen von Add-Ins.

4. Geben Sie das Add-In erneut frei.

   Nachdem Sie das Add-In getestet haben und überprüft haben, ob es wie erwartet funktioniert, können Sie das Add-In freigeben. Weitere Informationen finden Sie unter Freigeben von Add-Ins.