Partagez vos extensions avec le monde entier !

Au cours de l'année dernière, SketchUp a été activé plus de 30 millions de fois, dont plus de 2,5 millions de sessions actives chaque semaine. Chaque seconde, SketchUp est lancé par 30 personnes dans le monde. Extension Warehouse vous permet de partager votre extension SketchUp avec l'ensemble de la communauté SketchUp.

Processus de publication

Description générale du processus de publication de votre extension dans Extension Warehouse :

1. Écrivez du code : proposez une idée innovante qui, selon vous, aidera les utilisateurs de SketchUp à concrétiser une idée. Testez votre programme pour vous assurer qu'il fonctionne comme vous le souhaitez.
2. Créez votre programme d'installation de l'extension rbz : construisez le fichier RBZ de sorte à pouvoir le publier, conformément aux exigences techniques énoncées sur cette page.
3. Téléchargez-le dans Extension Warehouse : remplissez le formulaire de téléchargement et décrivez votre extension afin que les utilisateurs potentiels sachent à quoi elle sert et si elle peut leur être utile.
4. Dernières vérifications et soumission : vérifiez que tout est en ordre, retenez votre souffle et appuyez sur le bouton « Submit for Review » (Envoyer pour examen).
5. Examen par l'équipe SketchUp : notre équipe d'examen à des extensions vérifie votre proposition et la valide pourvu qu'elle réponde à nos critères d'examen et d'acceptation. Si ce n'est pas le cas, nous vous envoyons un message expliquant ce qu'il faut corriger avant que votre extension ne soit publiée.
6. Extension prête à être publiée : ça y est ! Votre extension a franchi l'étape de l'examen. Elle est maintenant prête à être publiée. Une fois que nous avons approuvé votre extension, nous vous envoyons un e-mail vous informant de la bonne nouvelle.
7. Publication : à ce stade, vous devrez retourner sur la page « Mes extensions » pour la publier. Elle n'est pas visible par le public tant que vous ne l'avez pas publiée.

Consignes à respecter en vue de la publication

Cette section décrit les exigences auxquelles les développeurs doivent répondre avant que nous acceptions de publier leurs extensions dans Extension Warehouse. Ces exigences peuvent être modifiées de temps à autre, à notre discrétion.

Exigences liées à la soumission

Les conditions minimales de soumission d'extensions proposées aux utilisateurs de SketchUp dans Extension Warehouse sont décrites ci-après. Bien que votre proposition surpasse probablement les exigences qui suivent, sachez que nous ne transigerons pas sur ces conditions minimales. Les extensions proposées dans Extension Warehouse doivent être :

• Utiles : elles doivent offrir des fonctionnalités utiles aux utilisateurs de SketchUp.
• Uniques  : elles ne doivent pas simplement reproduire des fonctions ou des services existants du client SketchUp, mais, au contraire, étendre de manière significative une fonction principale ou ajouter une fonctionnalité entièrement nouvelle.

• Fonctionnelles : elles doivent être installées et fonctionner comme annoncé, sans provoquer de panne de SketchUp ni ralentir son fonctionnement.
   

  Pour vous assurer que votre extension est fonctionnelle et utile pour les clients, n'oubliez pas de consulter nos consignes UX.
• Sûres : elles ne doivent pas, par la faute du développeur, endommager les données de l'utilisateur ou son système d'exploitation.
• Documentées : elles doivent être documentées. L'équipe SketchUp ne documente pas les extensions à votre place.
• Prises en charge : le développeur d'une extension doit être disponible pour répondre aux questions d'assistance technique une fois que les utilisateurs ont installé son extension. L'équipe SketchUp n'offre pas d'assistance à vos utilisateurs.
• Enregistrées correctement en tant qu'archive RBZ : les fichiers RBZ ne sont rien d'autre que des archives ZIP de scripts Ruby et d'autres ressources, avec une structure de dossier interne particulière.
• Inaccessibles aux utilisateurs de SketchUp Make : les extensions ne doivent pas reproduire des fonctionnalités de SketchUp Pro qui ne sont pas disponibles pour les utilisateurs de SketchUp Make. Si votre extension reproduit des fonctions Pro, elle doit répondre à l'exigence « Unique » (voir ci-dessus) et ne doit pas fonctionner dans SketchUp Make.

Exigences techniques

Les exigences techniques minimales sont les suivantes pour toutes les extensions soumises. Ce sont les critères à respecter pour que votre extension se comporte bien et fonctionne efficacement dans l'application client SketchUp.

Nous partons du principe que vous êtes déjà un développeur SketchUp Ruby expérimenté. Si vous débutez en programmation, consultez les API documentées sur notre page développeur pour en savoir plus sur les extensions Sketchup et les fichiers RBZ.

• Package : Extension Warehouse n'accepte que les packages RBZ. Ce sont simplement des fichiers ZIP avec une extension différente. Nous avons des exigences quant au contenu de vos RBZ. À la racine du package RBZ, nous n'autorisons qu'un seul fichier Ruby qui charge votre extension, et un dossier qui contient le reste de vos fichiers d'extension.

  REMARQUE : le nom du dossier doit être identique à celui du fichier Ruby (sans l'extension ".rb").
• Nom d'extension unique : il est crucial de choisir un nom unique pour votre extension. Supposons que vous construisiez un plugin appelé Swivel Driver et que votre entreprise s'appelle GoCorp. Nous vous recommandons vivement de faire précéder le nom de vos fichiers d'extension de vos initiales ou du nom de votre entreprise.
• Espaces de noms : placez l'ensemble de votre programme dans un espace de noms pour éviter tout conflit avec les scripts d'autres développeurs.
• Bonne pratique pour l'annulation : si votre extension ajoute des éléments au modèle ou le modifie, il est fortement recommandé d'inclure ces étapes dans une commande CALL Model.start_operation / commit_operation afin que les utilisateurs puissent récupérer leur modèle avec un simple Edit > Undo (Modifier > Annuler).

Exigences en matière d'assistance

L'équipe SketchUp n'est pas responsable de l'assistance aux utilisateurs de votre extension. Vous devez mettre en place un système d'assistance pour vos utilisateurs. Il doit au minimum comprendre les éléments suivants :

• Documentation : un nombre stupéfiant d'utilisateurs qui installent des extensions SketchUp doivent localiser les nouvelles fonctionnalités dans l'interface utilisateur de SketchUp et comprendre leur fonctionnement... sans aucune assistance. Une extension réussie est une extension que les utilisateurs peuvent prendre en main. Ne négligez pas cette étape. Nous vous recommandons vivement de proposer sur la page d'assistance de votre site Web :

  Des étapes détaillées pour bien démarrer. Utilisez si possible des noms de menus et des captures d'écran spécifiques.

  • Une vidéo de démonstration.
  • Le cas échéant, un lien vers des fichiers d'exemple qui permettent aux utilisateurs de tester le plugin dans un scénario idéal.
• Contact pour obtenir de l'assistance : les utilisateurs doivent pouvoir vous contacter pour obtenir de l'aide. Indiquez un site Web ou une adresse électronique d'assistance dans les liens de votre profil de compte ou dans les champs de description de votre extension.
• Formation : bien que cela ne soit pas obligatoire, les utilisateurs apprécieront des vidéos de formation ou tout autre support similaire que vous pouvez leur offrir pour les aider à se familiariser avec l'outil.

Dépendances du code

Si votre extension dépend d'autres bibliothèques de code, vous devez les regrouper dans votre package d'extension ou fournir des instructions claires aux utilisateurs sur la manière de les télécharger et de les installer.

Raisons pour lesquelles nous pouvons rejeter votre extension

En réalité, il est possible que votre extension ne passe pas le cap de notre procédure d'examen. Si c'est le cas, il s'agit probablement d'un élément mineur facile à corriger. Voici la liste des raisons que nous pouvons invoquer pour refuser une extension. Elle vise à vous guider pour augmenter les chances de réussite de votre extension lors de la procédure d'examen.

Votre extension se bloque lorsqu'elle est utilisée, provoque le blocage de SketchUp ou ralentit les performances lorsqu'elle est chargée. Si elle tombe en panne, elle n'est d'aucune utilité.

Votre extension bloque l'extension de quelqu'un d'autre ou la rend moins performante. Le principe d'Extension Warehouse implique d'accepter la participation de tous. Ce système ne fonctionne vraiment que si tout le monde respecte les règles du jeu.

Votre extension présente des bugs évidents qui l'empêchent de fonctionner comme prévu. Personne n'aime les programmes qui ne fonctionnent pas correctement. Ils donnent une mauvaise image de vous et de nous. Testez votre programme avant de le soumettre et assurez-vous qu'il fonctionne selon vos attentes.

Votre extension ne fonctionne pas comme annoncé. Ne faites pas de la « publicité-appât ». Vous devez décrire ce que fait votre extension et fournir cette fonctionnalité.

Votre extension utilise des API non documentées dans SketchUp. Les API non documentées ne sont pas sûres car elles sont susceptibles d'être modifiées à tout moment et n'ont probablement pas été bien testées. En d'autres termes, elles ne fonctionneront peut-être plus demain. Et même si c'est le cas, elles ne fonctionnent probablement pas bien ni de manière fiable dès à présent parce que nous ne les avons pas testées convenablement.

Votre extension est une copie de l'extension d'une autre personne. Une extension que vous revendiquez comme étant la vôtre ne doit pas être une simple copie du travail de quelqu'un d'autre. Faites preuve d'innovation, ou au moins ajoutez quelque chose de nouveau si vous proposez un produit dérivé. Ne vous contentez pas de copier.

Votre extension est un spam. Les extensions qui ne sont qu'une publicité pour quelque chose d'autre ne sont pas acceptées.

Le spam viole nos conditions de service, notre contrat de licence d'utilisateur final ou notre politique de confidentialité.

Il porte atteinte à la marque, aux droits d'auteur ou aux brevets d'un tiers.

Il exécute un code malveillant destiné à endommager l'ordinateur d'un autre utilisateur.

Il contient des informations, des images ou des matériaux inappropriés, diffamatoires, obscènes, indécents, pornographiques ou illégaux.

Il ne respecte pas toutes les exigences légales en vigueur.