Jak vytvářet skripty v Affinity a spravovat knihovnu

Přejmenování vrstev, opakování změny na více stránkách nebo příprava mnoha souborů k exportu může být časově náročnější než samotný návrh. Pokud jste již skripty používali v kreativních aplikacích, pravděpodobně vás zajímá... Jak vytvářet a spouštět skripty v Affinity a pokud k tomu potřebujete další nástroje.

Odpověď se změnila s aktualizací ze září 2026: Affinity obsahuje editor skriptůKromě panelu, kde k nim máte snadný přístup a můžete je spouštět, jsou k dispozici také komunitou vyvinutí správci pro organizaci JavaScriptových souborů a objevování nástrojů sdílených ostatními uživateli. Pojďme si rozlišit, co můžete v Affinity dělat a kdy má smysl použít externí aplikaci.

Jak fungují skripty v Affinity

Afinitní skripty jsou založeny na JavaScript a jeho vlastní SDKkterý definuje funkce dostupné pro interakci s aplikací. To neznamená, že soubor .jsx Připraveno pro přímý provoz s aplikací Adobe: ačkoli obě prostředí používají JavaScript, každé z nich používá své vlastní funkce pro přístup k dokumentům, vrstvám a nástrojům.

Affinity spojuje vektorovou grafiku, úpravu pixelů a sazbu v jedné aplikaci. To znamená, že skript může pracovat na různých částech dokumentu, aniž by bylo nutné přepínat mezi programy. V rámci možností SDK můžete vytvářet automatizace pro přípravu opakovaných prvků, aktualizaci komponent návrhu nebo generování variant projektu.

Mějte na paměti, že Funkce skriptování je stále v beta verzi.Dokumentace SDK může obsahovat chyby nebo opomenutí, proto je vhodné zkontrolovat výstup každého skriptu před jeho použitím ve větším projektu.

Vytvářejte a spouštějte skripty pomocí vestavěného editoru

Nejpřímějším způsobem je použití Vestavěný editor AffinityAplikace umožňuje psát a spouštět skripty, aniž byste se museli spoléhat na Clauda nebo instalovat Affinity Script Manager. Obsahuje také knihovnu příkladů, které vám pomohou pochopit strukturu skriptu před vytvořením vlastního.

1. Aktualizovat afinitu na verzi, která obsahuje funkci skriptování a otevírá testovací dokument.
2. Vyhledejte editor a panel skriptů v aplikaci. Pokud překlad nabídky neodpovídá dokumentaci, hledejte také názvy „Skripty“ nebo „Indexy“.
3. Otevřete jeden z přiložených příkladů a pozorujte, které prvky dokumentu používá a upravuje.
4. Vytvořte malou verzi vaší automatizacese změnou, kterou lze snadno ověřit, před jejím použitím na více stránek nebo vrstev.
5. Spusťte skript a podívejte se na výsledek. Jakmile bude fungovat podle očekávání, uložte jej, abyste jej mohli načíst z panelu.

Před psaním složitějších funkcí se poraďte s oficiální dokumentace k Affinity SDKJe to vhodná reference pro kontrolu, jaké operace existují a jak se používají v nainstalované verzi.

Kdy použít Správce skriptů Affinity

Správce afinitních skriptů Je to komunitní aplikace nezávislá na Affinity a Canvě. Mohla by vás zajímat, pokud nashromáždíte hodně souborů. .jsChcete spravovat lokální knihovnu, nebo byste raději prozkoumávali skripty publikované jinými lidmi z jednoho rozhraní?

Projekt nabízí editor založený na platformě Ace, možnosti importu a exportu skriptů a sekci komunitních nástrojů. Zahrnuje také Režim hodinekKdyž uložíte změny do již nainstalovaného skriptu, správce se pokusí jej odeslat zpět do Affinity. Pro komunikaci mezi oběma aplikacemi se používá lokální most MCP od Affinity; toto připojení je nezbytné pro instalaci skriptů prostřednictvím správce.

Pokud si to chcete vyzkoušet, stáhněte si to z repozitář jeho vývojáře na GitHubuMůžete začít importem vlastního skriptu do místní knihovny a následnou kontrolou, zda se zobrazuje v Affinity. U skriptů třetích stran zkontrolujte kód a nejprve jej otestujte na kopii dokumentu.

Jak sdílet skripty a komunitní repozitáře

Soubor .js Skript, který sdílíte prostřednictvím Affinity Script Manageru, může na začátku obsahovat komentář s metadaty. Správce tyto informace použije k zobrazení názvu a popisu ve své knihovně. Podle projektové dokumentace… name Je to povinné, description Doporučuje se a version Je to volitelné.

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

Ten blok stačí jen popište scénářNíže musíte přidat kód, který úlohu spustí. Použijte název, který vysvětluje, co úloha dělá, a zdokumentujte všechny důležité podmínky, jako je například nutnost vybrat vrstvy před jejím spuštěním.

Pokud si chcete ponechat váš vlastní veřejný katalog Dokumentace je kompatibilní se správcem a vysvětluje, jak vytvořit repozitář GitHub se souborem. registry.json v kořenovém adresáři. Tento záznam označuje, kam stáhnout jednotlivé skripty, a může obsahovat kategorie a vzorové obrázky. Soubor featured.json Je to volitelné a řídí vybrané položky v daném repozitáři. Chcete-li navrhnout skript do existujícího komunitního katalogu, jeho správci uvádějí jiný způsob: odešlete návrh k posouzení prostřednictvím problému na GitHubu.

Co zkontrolovat, pokud se skript nezobrazuje nebo nefunguje

První rozlišování kde proces selháváPokud používáte editor Affinity a skript se spustí, ale negeneruje očekávaný výsledek, zkontrolujte kód, otevřený dokument, aktivní výběr a funkce SDK, které používá. Před opakováním na velkém projektu jej otestujte na malém souboru.

Pokud se problém objeví, když nainstalujte skript z Affinity Script ManageruOvěřte, zda je otevřený Affinity a zda je povolen MCP s oprávněním k ukládání skriptů. Vývojář správce skriptů také doporučuje otevřít panel skriptů a vytvořit alespoň jednu kategorii před dalším pokusem o instalaci.

V systému macOS může správce zobrazit varování, protože vaše aplikace není ověřena. Pokud se rozhodnete ji nainstalovat, stáhněte si ji z repozitáře vývojáře, ověřte, zda odpovídá projektu, který chcete použít, a postupujte podle bezpečnostních pokynů systému.

Chcete-li začít automatizovat Affinity, Vestavěný editor a jeho příklady jsou dostatečné.Správce komunity zajišťuje organizaci a přístup k dalším skriptům s tím, jak se vaše knihovna rozrůstá. Bez ohledu na zvolenou metodu si uschovejte kopii původního dokumentu a před odesláním práce vždy zkontrolujte změny a exporty.