Créez votre propre extension personnalisée pour PopClip

PopClip est l'une de nos applications préférées sur Mactuts + et l'une des raisons pour lesquelles elle prend en charge les extensions. Vous pouvez effectuer des actions sur le texte sélectionné à l'aide de PopClip, ce qui le rend extrêmement polyvalent, que vous souhaitiez ouvrir un lien dans un autre navigateur, rechercher le texte sélectionné dans Google ou l'ajouter en tant que tâche à faire, PopClip fournit une interface de style iOS. menu contextuel facilitant ces tâches.

Dans ce tutoriel, je vais montrer à quel point il est facile de créer le tien extension pour PopClip pour effectuer une action personnalisée.


Qu'est-ce que PopClip??


PopClip fournit un menu de style iOS qui peut être personnalisé avec des extensions.

PopClip (4,99 $) est une application pour OS X qui propose un menu contextuel de type iOS lors de la sélection de texte. Son utilisation principale est de couper, copier et coller - encore une fois, très similaire à iOS. Ce qui est vraiment intéressant, c’est la possibilité d’installer des extensions pour faire plus que simplement ajouter au presse-papiers..

Au moment de la rédaction de cet article, plus de 92 extensions étaient disponibles au téléchargement gratuitement. Ces extensions vont de l’ouverture d’un lien dans Google Chrome à la publication de texte sélectionné sur Facebook, en passant par des guillemets autour du texte sélectionné, etc..

Pointe: Il y a beaucoup d'extensions et je vous encourage à y jeter un coup d'œil, vous les trouverez toutes sur la page des extensions PopClip..

J'utilise PopClip régulièrement et j'utilise une extension pour ajouter du texte sélectionné à Things, mon application de choix.


Comment ils sont construits

PopClip prend en charge les extensions écrites de différentes manières:

  • Service Mac OS X
  • AppleScript
  • Script shell
  • URL
  • Appuyez sur la touche

Tous les deux URL et Appuyez sur la touche ne nécessite aucune connaissance en programmation pour les créer. Si vous connaissez l'URL d'un site pouvant inclure du texte ou appuyez sur une certaine combinaison de touches, vous pouvez créer votre propre extension..

Les trois autres sont créés en utilisant script langues. Ils peuvent manipuler du texte de manière plus avancée. Pour les besoins de ce tutoriel, je vais créer une extension en utilisant le URL méthode.

UNE URL l'extension ne nécessite que deux fichiers, notre fichier de configuration d'extension et une icône à afficher dans le menu contextuel lorsque nous sélectionnons du texte.


Construire notre propre

Nous pouvons utiliser un grand choix d'extensions, mais il se peut que celles-ci ne répondent pas exactement à nos besoins. Par exemple, je vais vous montrer comment construire une extension PopClip qui peut rechercher Mactuts + pour le texte sélectionné.

Pour ce faire, je ne vous expliquerai pas comment en créer un, mais nous utiliserons une partie de l'exemple de code fourni par le développeur et nous y apporterons des modifications pour répondre à nos besoins. Cela vous donnera une bonne idée du fonctionnement de l'extension et des modifications à apporter pour créer nos propres extensions..

Astuce: nous n’aurons besoin que d’un éditeur de texte pour apporter des modifications. TextEdit n'est pas idéal pour éditer du code, je vous recommande donc quelque chose comme TextWrangler, qui est non seulement une application géniale, mais également gratuite.!


1. Créer un dossier


Vous pouvez créer ce dossier n'importe où, car ce sera simplement un endroit où travailler

Sur votre bureau (ou où que vous soyez), créez un dossier appelé mactuts. C'est ici que nous allons stocker nos fichiers d'extension avant de les transformer en une extension PopClip appropriée..


2. Télécharger le code source

Sur le site de développement PopClip Extension, nous pouvons télécharger un exemple de code source. Sous le titre Aperçu général, vous verrez les types d'actions que PopClip prend en charge. Nous voulons télécharger l'exemple de code pour le URL action, qui est le code source de la Google Traduction extension.

Vous verrez deux fichiers dans la vue, le Config.plist et TranslationIcon.png. Nous ne sommes intéressés que par le fichier de configuration.


Voici à quoi ressemble le code lorsqu'il est ouvert / collé dans un éditeur de texte (dans ce cas, TextMate)

Le fichier de configuration principal d’une extension est ce que l’on appelle un Liste de propriété fichier, autrement connu comme un Pliste. Vous en avez peut-être entendu parler auparavant car il s'agit du même type de fichier que celui utilisé par OS X pour stocker les préférences des applications. Il est basé sur un format appelé XML. Prenez quelques minutes pour vous familiariser avec le format.

Semble familier? XML est conçu pour fonctionner de la même manière que HTML, le langage de balisage utilisé pour construire des pages Web.

Pointe: Si vous souhaitez en savoir plus sur les listes de propriétés, la bibliothèque de développeurs d’Apple contient un excellent article d’introduction que vous pouvez lire.

Si vous n'êtes pas familier avec GitHub, vous pouvez télécharger l'extension directement. (Cliquez avec le bouton droit sur le lien et sélectionnez Télécharger le fichier sous… , le sauver au mactuts dossier que nous avons créé plus tôt).


3. Modifions!

A présent, vous auriez dû enregistrer le Config.plist déposer dans votre mactuts dossier. Éditons ce fichier dans un éditeur de texte.

Comme vous l'avez vu, ce fichier contient différentes options configurables. Vous remarquerez qu'une option s'appelle un Clé. Ceux-ci indiquent à PopClip que l'extension est capable de fournir certaines informations. Nous ne changerons aucun clés, mais au lieu de cela, nous allons modifier les informations au sein de.

Étape 1


La première chose à changer est le nom et la description de l'extension.

Tout d’abord, nous devons changer notre Nom de l'extension et Description de l'extension. Trouvez la ligne qui a le clé Pour cela, changez le nom qui se trouve dans la chaîne ci-dessous, actuellement écrit «Google Translate» en conséquence. Rappelez-vous, ne changez pas la clé.

Maintenant que vous avez modifié le nom de l'extension, changeons la description pour mieux refléter son rôle. En suivant les mêmes étapes que ci-dessus, modifiez la description pour mieux décrire les tâches de notre extension Mactuts + search. Je vous laisse le soin de décider quoi écrire.

Étape 2


Nous devrons également mettre à jour la version car il s’agit de la première extension Mactuts à ce jour.!

Maintenant, comme c'est la première fois que nous allons créer cette extension, faisons-la version 1. Localisez le numéro de version situé en haut du fichier et modifiez-le de 2 à 1.

Vous avez peut-être remarqué que, contrairement au nom de l’extension, c’est ce qu’on appelle un Entier et pas Chaîne. Entier signifie simplement que vous ne spécifiez qu'un nombre, donc pas de lettres ni de caractères spéciaux.

Étape 3


L'identifiant doit être modifié car il est unique pour chaque extension et développeur.

Chaque extension nécessite une manière unique d'être identifiée. Plutôt que d'utiliser son nom, il utilise un identifiant spécial qui ressemble à un nom de domaine écrit à l'envers. Dans ce code source, vous verrez qu'il est écrit comme suit:

com.pilotmoon.popclip.extension.google-translate

Changez ceci en ceci:

com.mactuts.extension.mactuts-search

Même si nous changions le nom de l'extension, PopClip aurait tout de même cette confusion si nous avions notre extension et l'extension Google Translate installées en même temps..

Étape 4

Il est maintenant temps de contrôler le fonctionnement de l'extension. Notre extension recherchera Mactuts + pour le texte que vous avez sélectionné. Pour ce faire, nous devons savoir quelle est notre adresse de recherche..

Ouvrez un nouvel onglet ou une nouvelle fenêtre avec Mactuts + chargé et recherchez le mot clé "TEST". Une fois la recherche terminée, jetez un coup d'œil à la barre d'adresse. Vous devriez voir l'adresse suivante:

http://mac.tutsplus.com/?s=TEST

À partir de là, nous pouvons voir que l’adresse de recherche est:

http://mac.tutsplus.com/?s=

Vous pouvez le vérifier en entrant l'adresse ci-dessus, puis le mot clé de votre choix dans la barre d'adresse de votre navigateur. Une fois la page chargée, vous verrez la recherche que vous vouliez.

PopClip utilise le texte texte popclip comme espace réservé pour le texte que vous avez sélectionné. Cela signifie que l'adresse de recherche de notre extension sera:

http://mac.tutsplus.com/?s=popclip text


Nous allons maintenant changer l'URL ouverte par PopClip (avec le texte sélectionné) pour rechercher des Mactuts+

Cette adresse de recherche est ce qui alimentera notre extension. Dans le fichier de configuration, modifiez le Chaîne c'est sous la section pour URL à ce qui précède.

Étape 5


Notre icône utilisée par PopClip doit être un carré de 256 pixels avec un fond transparent et une zone pleine en noir.

Avec la fonction de recherche principale configurée, nous devons ajouter une icône. L’icône doit être un PNG transparent 256px carré. Pour gagner du temps, j'en ai inclus un avec le fichier source que vous pouvez télécharger et utiliser.

Ajoutez cette icône (ou votre propre icône) à votre mactuts dossier. J'ai nommé l'icône que j'ai fournie MactutsIcon.png.


Une fois que nous avons ajouté une nouvelle image, nous devons mettre à jour le fichier de configuration avec le nouveau nom.

De retour au fichier de configuration, nous devons changer le nom du Fichier d'image à celui que nous utilisons maintenant.

Étape 6


Enfin, modifiez le titre de l’extension et supprimez la "clé" et la "chaîne" pour "Expression régulière".

Modifiez le titre de la fenêtre contextuelle de «Traduire» à «Mactuts +». En outre, supprimez le Clé et Chaîne relatif à Expression régulière. Ceci est un extra facultatif dont nous n'avons pas besoin.

Étape 7

Notre extension est maintenant prête à partir. Afin de commencer à l'utiliser, nous devons le convertir en une extension PopClip. Toutes les extensions PopClip sont en fait des dossiers spécialement nommés. Il n'y a aucun outil de conversion ou astuce en ligne de commande à faire.


Dupliquez le dossier sur lequel nous travaillons et renommez-le en ajoutant ".popclipext" à la fin.

Tout d'abord dupliquer le dossier. Avec le dossier récemment dupliqué, renommez-le en mactuts.popclipext. Le Finder vous demandera de confirmer que vous souhaitez le renommer..


On vous demandera si vous êtes sûr de vouloir ajouter une extension de fichier au dossier dupliqué.

4. Installer et tester l'extension


PopClip avertira que cette extension n'est pas signée, ce qui signifie qu'elle n'a pas été approuvée par le développeur. Comme c'est tout neuf, ça va

Une fois la conversion effectuée, double-cliquez sur le fichier d’extension nouvellement créé à installer. PopClip vous avertit que cette extension n'est pas approuvée. Ne vous inquiétez pas, cela signifie simplement que nous souhaitons installer une extension ne provenant pas du site Web du développeur. Confirmez que vous souhaitez l'installer, puis l'extension l'installera. Une fois installé, vous le verrez dans la liste des extensions actives de PopClip. Au bas de la liste se trouve notre nouvelle extension Mactuts +!


Une fois installé, PopClip affichera notre nouvelle extension dans le menu.

Maintenant pour le tester. Mettez en surbrillance du texte n’importe où et lorsque PopClip apparaît, vous devriez maintenant voir l’affichage de notre bouton Mactuts + search.


La sélection de texte affichera le menu PopClip… ainsi que notre nouvelle extension.!

Cliquez dessus pour ouvrir un nouvel onglet ou une nouvelle fenêtre (ou même lancer) votre navigateur par défaut et ouvrir directement la page des résultats de la recherche pour ce que vous avez sélectionné..


Une fois sélectionné, PopClip ouvrira un nouvel onglet avec le texte sélectionné recherché sur Mactuts+

Emballer

À la fin de ce didacticiel, j'espère que vous en aurez beaucoup appris et que vous aurez commencé à créer des extensions plus avancées. La page de développement des extensions PopClip sur GitHub vous fournit le code source de tous les types d’extensions afin que vous puissiez voir exactement comment elles fonctionnent..

Construire une extension pour PopClip peut être incroyablement facile, vous n'aurez peut-être pas besoin d'attendre que quelqu'un développe une extension que vous attendiez, vous pourrez peut-être le construire vous-même.!