Wie man Skripte in Affinity erstellt und die Bibliothek verwaltet

Das Umbenennen von Ebenen, das Wiederholen einer Änderung auf mehreren Seiten oder das Vorbereiten zahlreicher Dateien für den Export kann zeitaufwändiger sein als das Designen selbst. Wenn Sie bereits Skripte in kreativen Anwendungen verwendet haben, fragen Sie sich wahrscheinlich … Wie man Skripte in Affinity erstellt und ausführt und falls Sie dafür zusätzliche Werkzeuge benötigen.

Die Antwort hat sich mit dem Update vom September 2026 geändert: Affinity beinhaltet einen SkripteditorNeben einem Bedienfeld, über das Sie einfach darauf zugreifen und sie ausführen können, gibt es auch von der Community entwickelte Manager zur Organisation von JavaScript-Dateien und zum Auffinden von Tools, die von anderen Nutzern geteilt werden. Lassen Sie uns unterscheiden, was Sie innerhalb von Affinity tun können und wann die Verwendung einer externen Anwendung sinnvoll ist.

Wie Skripte in Affinity funktionieren

Affinity-Skripte basieren auf JavaScript und sein eigenes SDKDiese Definition legt die Funktionen fest, die für die Interaktion mit der Anwendung zur Verfügung stehen. Dies bedeutet nicht, dass eine Datei .jsx Für die direkte Nutzung in einer Adobe-Anwendung vorbereitet: Obwohl beide Umgebungen JavaScript verwenden, nutzt jede ihre eigenen Funktionen für den Zugriff auf Dokumente, Ebenen und Werkzeuge.

Affinity vereint Vektorgrafik, Pixelbearbeitung und Layout in einer einzigen Anwendung. So kann ein Skript verschiedene Teile eines Dokuments bearbeiten, ohne dass ein Programmwechsel erforderlich ist. Sie können Automatisierungen erstellen, um wiederkehrende Elemente vorzubereiten, Designkomponenten zu aktualisieren oder Projektvarianten zu generieren – alles im Rahmen der Möglichkeiten des SDKs.

Denken Sie daran, dass Die Skriptfunktion befindet sich noch in der Beta-Phase.Die SDK-Dokumentation kann Fehler oder Auslassungen enthalten. Daher ist es ratsam, die Ausgabe jedes Skripts zu überprüfen, bevor man es in einem größeren Projekt verwendet.

Erstellen und führen Sie Skripte mit dem integrierten Editor aus.

Der direkteste Weg ist die Verwendung von Der in Affinity integrierte EditorDie Anwendung ermöglicht das Schreiben und Ausführen von Skripten, ohne auf Claude angewiesen zu sein oder den Affinity Script Manager installieren zu müssen. Sie enthält außerdem eine Beispielbibliothek, die Ihnen hilft, die Skriptstruktur zu verstehen, bevor Sie eigene Skripte erstellen.

1. Affinität aktualisieren zu einer Version, die die Skriptfunktion enthält und ein Testdokument öffnet.
2. Suchen Sie den Editor und das Skriptfenster. in der Anwendung. Falls die Menüübersetzung nicht mit der Dokumentation übereinstimmt, suchen Sie auch nach den Bezeichnungen „Skripte“ oder „Indizes“.
3. Öffnen Sie eines der enthaltenen Beispiele. und beobachten Sie, welche Elemente des Dokuments es verwendet und welche es verändert.
4. Erstelle eine kleine Version deiner Automatisierung., mit einer Änderung, die leicht zu überprüfen ist, bevor sie auf mehrere Seiten oder Ebenen angewendet wird.
5. Führe das Skript aus und überprüfe das Ergebnis. Wenn alles wie erwartet funktioniert, speichern Sie es, um es später aus dem Bedienfeld wieder abzurufen.

Bevor Sie komplexere Funktionen schreiben, konsultieren Sie die offizielle Affinity SDK-DokumentationEs ist die geeignete Referenz, um zu überprüfen, welche Operationen vorhanden sind und wie sie in der installierten Version verwendet werden.

Wann sollte man den Affinity Script Manager verwenden?

Affinity Script Manager Es handelt sich um eine Community-basierte App, die unabhängig von Affinity und Canva ist. Sie könnte für Sie interessant sein, wenn Sie viele Dateien ansammeln. .jsMöchten Sie eine lokale Bibliothek pflegen oder bevorzugen Sie es, Skripte anderer Autoren über eine einzige Benutzeroberfläche zu erkunden?

Das Projekt bietet einen auf Ace basierenden Editor, Optionen zum Importieren und Exportieren von Skripten sowie einen Bereich mit Community-Tools. Es umfasst außerdem UhrenmodusWenn Sie Änderungen an einem bereits installierten Skript speichern, versucht der Manager, dieses an Affinity zurückzusenden. Zur Kommunikation zwischen den beiden Anwendungen nutzt er die lokale MCP-Brücke von Affinity; diese Verbindung ist für die Installation von Skripten über den Manager erforderlich.

Wenn Sie es ausprobieren möchten, laden Sie es von der Website herunter. Repository des Entwicklers auf GitHubSie können damit beginnen, Ihr eigenes Skript in Ihre lokale Bibliothek zu importieren und anschließend zu prüfen, ob es in Affinity angezeigt wird. Bei Skripten von Drittanbietern sollten Sie den Code überprüfen und ihn zunächst an einer Kopie eines Dokuments testen.

Wie man Skripte und Community-Repositories teilt

Eine Datei .js Das Skript, das Sie über den Affinity Script Manager freigeben, kann am Anfang einen Kommentar mit seinen Metadaten enthalten. Der Manager verwendet diese Informationen, um Name und Beschreibung in seiner Bibliothek anzuzeigen. Laut Projektdokumentation name Es ist obligatorisch, description Es wird empfohlen und version Es ist optional.

/**
 * name: Preparar capas para exportar
 * description: Organiza las capas seleccionadas antes de exportarlas.
 * version: 1.0.0
 */

Dieser Block Beschreiben Sie einfach das Skript.Im Folgenden müssen Sie den Code hinzufügen, der die Aufgabe ausführt. Verwenden Sie einen aussagekräftigen Namen, der die Funktion beschreibt, und dokumentieren Sie alle wichtigen Bedingungen, z. B. die Notwendigkeit, vor der Ausführung Ebenen auszuwählen.

Wenn Sie behalten möchten Ihr eigener öffentlicher Katalog Kompatibel mit dem Manager, erklärt die zugehörige Dokumentation, wie man ein GitHub-Repository mit einer Datei erstellt. registry.json im Stammverzeichnis. Dieser Eintrag gibt an, wo die einzelnen Skripte heruntergeladen werden können und kann Kategorien und Beispielbilder enthalten. Die Datei featured.json Die Angabe ist optional und steuert die hervorgehobenen Elemente in diesem Repository. Um ein Skript für den bestehenden Community-Katalog vorzuschlagen, empfehlen die Verantwortlichen eine andere Methode: die Einreichung eines Vorschlags über ein GitHub-Issue zur Überprüfung.

Was zu überprüfen ist, wenn ein Skript nicht angezeigt wird oder nicht funktioniert

Zunächst unterscheiden wo der Prozess fehlschlägtWenn Sie den Affinity-Editor verwenden und das Skript zwar ausgeführt wird, aber nicht das erwartete Ergebnis liefert, überprüfen Sie den Code, das geöffnete Dokument, die aktive Auswahl und die verwendeten SDK-Funktionen. Testen Sie es zunächst an einer kleinen Datei, bevor Sie es in einem großen Projekt anwenden.

Wenn das Problem auftritt, wenn Installieren Sie ein Skript aus dem Affinity Script Manager.Vergewissern Sie sich, dass Affinity geöffnet und MCP mit der Berechtigung zum Speichern von Skripten aktiviert ist. Der Entwickler des Skriptmanagers empfiehlt außerdem, das Skript-Panel zu öffnen und mindestens eine Kategorie anzulegen, bevor Sie die Installation erneut versuchen.

Unter macOS kann der Manager eine Warnung anzeigen, da Ihre Anwendung nicht notariell beglaubigt ist. Wenn Sie sie dennoch installieren möchten, laden Sie sie aus dem Repository des Entwicklers herunter, vergewissern Sie sich, dass sie mit dem gewünschten Projekt übereinstimmt, und befolgen Sie die Sicherheitshinweise des Systems.

Um mit der Automatisierung von Affinity zu beginnen, Der integrierte Editor und seine Beispiele sind ausreichend.Der Community-Manager sorgt für Ordnung und Zugriff auf weitere Skripte, wenn Ihre Bibliothek wächst. Unabhängig von der Methode sollten Sie eine Kopie des Originaldokuments aufbewahren und Änderungen sowie Exporte stets überprüfen, bevor Sie Ihre Arbeit einreichen.