Comment créer des scripts dans Affinity et gérer votre bibliothèque

Renommer les calques, répéter une modification sur plusieurs pages ou préparer de nombreux fichiers pour l'exportation peut s'avérer plus chronophage que la conception elle-même. Si vous avez déjà utilisé des scripts dans des applications créatives, vous vous demandez probablement… Comment créer et exécuter des scripts dans Affinity et si vous avez besoin d'outils supplémentaires pour y parvenir.

La réponse a changé avec la mise à jour de septembre 2026 : Affinity intègre un éditeur de scriptsOutre un panneau permettant d'y accéder et de les exécuter facilement, il existe également des gestionnaires développés par la communauté pour organiser les fichiers JavaScript et découvrir les outils partagés par d'autres utilisateurs. Voyons ce que vous pouvez faire au sein d'Affinity et quand il est judicieux d'utiliser une application externe.

Comment fonctionnent les scripts dans Affinity

Les scripts d'affinité sont basés sur JavaScript et son propre SDKqui définit les fonctions disponibles pour interagir avec l'application. Cela ne signifie pas qu'un fichier .jsx Conçu pour fonctionner directement avec une application Adobe : bien que les deux environnements utilisent JavaScript, chacun utilise ses propres fonctions pour accéder aux documents, aux calques et aux outils.

Affinity réunit graphisme vectoriel, édition pixel et mise en page dans une seule application. Un script peut ainsi agir sur différentes parties d'un document sans avoir à changer de programme. Vous pouvez créer des automatisations pour préparer des éléments répétitifs, mettre à jour des composants d'une maquette ou générer des variantes d'un projet, le tout grâce aux fonctionnalités du SDK.

Gardez à l'esprit que La fonctionnalité de script est encore en version bêta.La documentation du SDK peut contenir des erreurs ou des omissions ; il est donc conseillé de vérifier le résultat de chaque script avant de l'utiliser dans un projet important.

Créez et exécutez des scripts avec l'éditeur intégré

La méthode la plus directe consiste à utiliser L'éditeur intégré d'AffinityL'application permet d'écrire et d'exécuter des scripts sans avoir recours à Claude ni à l'installation d'Affinity Script Manager. Elle inclut également une bibliothèque d'exemples pour vous aider à comprendre la structure des scripts avant d'en créer de nouveaux.

1. Mettre à jour Affinity à une version qui inclut la fonction de script et ouvre un document de test.
2. Localisez l'éditeur et le panneau des scripts dans l'application. Si la traduction du menu ne correspond pas à la documentation, recherchez également les noms « Scripts » ou « Index ».
3. Ouvrez l'un des exemples inclus et observez quels éléments du document il utilise et modifie.
4. Créez une version réduite de votre automatisation., avec une modification facile à vérifier, avant de l'appliquer à plusieurs pages ou calques.
5. Exécutez le script et vérifiez le résultat. Lorsque cela fonctionne comme prévu, enregistrez-le pour le récupérer depuis le panneau.

Avant d'écrire des fonctions plus complexes, consultez le Documentation officielle du SDK AffinityIl s'agit du document de référence approprié pour vérifier quelles opérations existent et comment elles sont utilisées dans la version installée.

Quand utiliser Affinity Script Manager

Gestionnaire de scripts Affinity C'est une application communautaire indépendante d'Affinity et de Canva. Elle pourrait vous intéresser si vous accumulez beaucoup de fichiers. .jsSouhaitez-vous gérer une bibliothèque locale ou préférez-vous explorer les scripts publiés par d'autres personnes à partir d'une interface unique ?

Le projet propose un éditeur basé sur Ace, des options d'importation et d'exportation de scripts, ainsi qu'une section d'outils communautaires. Il comprend également : Mode visionnageLorsque vous enregistrez des modifications apportées à un script déjà installé, le gestionnaire tente de les renvoyer à Affinity. Pour communiquer entre les deux applications, il utilise le pont MCP local d'Affinity ; cette connexion est nécessaire à l'installation de scripts via le gestionnaire.

Si vous voulez l'essayer, téléchargez-le depuis le dépôt de son développeur sur GitHubVous pouvez commencer par importer votre propre script dans votre bibliothèque locale, puis vérifier s'il apparaît dans Affinity. Pour les scripts tiers, examinez le code et testez-le d'abord sur une copie d'un document.

Comment partager des scripts et des dépôts communautaires

Un fichier .js Le script que vous partagez via Affinity Script Manager peut inclure un commentaire contenant ses métadonnées au début. Le gestionnaire utilise ces informations pour afficher le nom et la description du script dans sa bibliothèque. Selon la documentation du projet, name C'est obligatoire, description Il est recommandé et version C'est facultatif.

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

Ce bloc Décrivez simplement le scriptVous devez ajouter ci-dessous le code qui exécutera la tâche. Choisissez un nom explicite et indiquez les conditions importantes, comme la nécessité de sélectionner les calques avant l'exécution.

Si vous voulez garder votre propre catalogue public Compatible avec le gestionnaire, sa documentation explique comment créer un dépôt GitHub contenant un fichier registry.json dans le répertoire racine. Cette entrée indique où télécharger chaque script et peut inclure des catégories et des exemples d'images. Le fichier featured.json C'est facultatif et cela permet de contrôler les éléments mis en avant dans ce dépôt. Pour proposer un script au catalogue communautaire existant, ses responsables indiquent une autre méthode : soumettre une proposition via une issue GitHub pour examen.

Que vérifier si un script n'apparaît pas ou ne fonctionne pas ?

Premièrement, distinguer où le processus échoueSi vous utilisez l'éditeur Affinity et que le script s'exécute sans produire le résultat attendu, vérifiez le code, le document ouvert, la sélection active et les fonctionnalités du SDK utilisées. Testez-le sur un petit fichier avant de l'appliquer à un projet important.

Si le problème apparaît lorsque installer un script depuis Affinity Script ManagerVérifiez qu'Affinity est ouvert et que MCP est activé avec l'autorisation d'enregistrer les scripts. Le développeur du gestionnaire de scripts recommande également d'ouvrir le panneau de scripts et de créer au moins une catégorie avant de tenter une nouvelle installation.

Sous macOS, le gestionnaire peut afficher un avertissement car votre application n'est pas notariée. Si vous décidez de l'installer, téléchargez-la depuis le dépôt du développeur, vérifiez qu'elle correspond bien au projet que vous souhaitez utiliser et suivez les instructions de sécurité du système.

Pour commencer l'automatisation d'Affinity, L'éditeur intégré et ses exemples sont suffisants.Le gestionnaire de communauté facilite l'organisation et l'accès à davantage de scripts à mesure que votre bibliothèque s'agrandit. Quelle que soit la méthode, conservez une copie du document original et vérifiez toujours les modifications et les exportations avant de soumettre votre travail.