Creați propria extensie personalizată pentru PopClip

PopClip este una dintre aplicațiile noastre favorite pe Mactuts + și unul dintre motivele pentru care este suportul pentru extensii. Puteți efectua acțiuni pe textul selectat utilizând PopClip care îl face extrem de versatil, indiferent dacă doriți să deschideți o legătură într-un alt browser, să căutați textul selectat pe Google sau să-l adăugați ca un serviciu de lucruri, PopClip oferă un stil iOS meniu pop-up care face ca aceste sarcini să fie ușor de realizat.

În acest tutorial, voi demonstra cât de ușor este să creați al tau extensie pentru PopClip pentru a efectua o acțiune personalizată.


Ce este PopClip?


PopClip oferă un meniu în stil iOS care poate fi personalizat în continuare cu extensii

PopClip ($ 4.99) este o aplicație pentru OS X care oferă un meniu pop-up de tip iOS când selectezi text. Utilizarea principală este de tăiere, copiere și lipire - din nou, foarte asemănătoare cu iOS. În cazul în care devine cu adevărat interesant este capacitatea de a instala extensii pentru a face mai mult decât să adăugați doar în clipboard.

La momentul redactării, au fost disponibile peste 92 de extensii pentru descărcare gratuită. Aceste extensii variază de la deschiderea unui link într-un Google Chrome, postarea textului selectat pe Facebook, adăugarea de ghilimele în jurul textului selectat și multe altele.

Bacsis: Există multe extensii și vă încurajez să aruncați o privire, toate acestea putând fi găsite la pagina de extensii PopClip.

Folosesc în mod regulat PopClip și folosesc o extensie pentru adăugarea textului selectat la Lucrurile, aplicația mea de rezolvat.


Cum sunt construite

PopClip acceptă extensii scrise în mai multe moduri:

  • Serviciul Mac OS X
  • AppleScript
  • Shell Script
  • URL-
  • keypress

Ambii URL- și keypress nu necesită cunoștințe de programare pentru a le crea. Atâta timp cât știți adresa URL a unui site care poate include un anumit text sau pentru a apăsa o anumită combinație de taste, atunci puteți crea propria extensie.

Celelalte trei sunt create folosind Scripting limbi. Ei pot manipula textul într-un mod mai avansat. În scopul acestui tutorial, voi crea o extensie folosind URL- metodă.

A URL- extensia necesită doar două fișiere, fișierul nostru de configurare a extensiei și o pictogramă care să fie afișată în meniul pop-up când selectăm un text.


Construirea propriilor noastre

Există o mare varietate de extensii pe care le putem folosi, dar nu poate fi una care să se potrivească exact nevoilor noastre. De exemplu, vă voi arăta cum să construiți o extensie PopClip care poate căuta Mactuts + pentru textul selectat.

Pentru a face acest lucru, nu vă voi arăta cum să construiți unul de la zero, dar, în schimb, vom folosi un exemplu de cod furnizat de dezvoltator și vom face modificări în funcție de nevoile noastre. Acest lucru vă va oferi o idee bună despre cum funcționează extinderea și ce modificări ar trebui să facem pentru a începe să ne creăm extensiile proprii.

Sfat: Vom avea nevoie doar de un editor de text pentru a face schimbări. TextEdit nu este ideal pentru editare cod, așa că aș recomanda ceva de genul TextWrangler, care nu este doar o aplicație excelentă, dar este și gratuit!


1. Creați un dosar


Puteți crea acest dosar oriunde, pentru că va fi de unde să lucreze pentru moment

Pe desktop (sau oriunde doriți), creați un dosar numit mactuts. Aici vom stoca fișierele extensiei înainte de ao transforma într-o extensie PopClip corespunzătoare.


2. Descărcați codul sursă

La site-ul de dezvoltatori PopClip Extension, putem descărca un exemplu de cod sursă. Sub titlul Privire de ansamblu, veți vedea tipurile de acțiuni suportate de PopClip. Vrem să descărcăm exemplul de cod pentru URL- acțiune, care este codul sursă pentru Traducerea Google extensie.

Veți vedea două fișiere în vizualizare, Config.plist și TranslationIcon.png. Suntem interesați doar de fișierul Config.


Iată ce arată codul atunci când este deschis / inserat într-un editor de text (în acest caz, TextMate)

Fișierul de configurare principal al unei extensii este ceea ce este cunoscut sub numele de a Lista de proprietăți fișier, altfel cunoscut sub numele de a plist. S-ar putea să fi auzit de ei înainte, deoarece este același tip de fișier pe care OS X îl folosește pentru a stoca preferințele pentru aplicații. Se bazează pe un format cunoscut sub numele de XML. Luați câteva minute pentru a vă familiariza cu formatul.

Arată cunoscut? XML este conceput pentru a lucra într-un mod similar cu HTML, limba de marcare folosită pentru a construi pagini web.

Bacsis: Dacă doriți să aflați mai multe despre listele de proprietăți, Biblioteca dezvoltatorilor Apple are un articol introductiv excelent pe care îl puteți citi

Dacă nu sunteți familiarizat cu GitHub, puteți descărca extensia direct. (Faceți clic dreapta pe link și selectați Descărcați fișierul ca ... , salvarea lui la mactuts dosarul creat mai devreme).


3. Să editați!

Până acum ar fi trebuit să-l salvezi Config.plist fișierul către dvs. mactuts pliant. Să editați acel fișier în cadrul unui editor de text.

După cum ați văzut, acest fișier are o serie de opțiuni configurabile diferite. Veți observa că o opțiune se numește a Cheie. Acestea spun PopClip că extensia este capabilă să furnizeze anumite informații. Nu vom schimba nimic chei, dar în schimb vom modifica informațiile în cadrul acestora.

Pasul 1


Primul lucru pe care îl vom schimba este numele și descrierea extensiei

Mai întâi de toate, trebuie să ne schimbăm Nume prelungire și Extensie Descriere. Găsiți linia care are cheie pentru aceasta și schimbați numele din șirul de mai jos, scris în prezent ca "Google Translate" în consecință. Amintiți-vă, nu schimbați cheia.

Acum că ați schimbat numele extensiei, să schimbăm descrierea pentru a reflecta mai bine ce face. Folosind aceiași pași ca mai sus, schimbați descrierea pentru a descrie mai bine ce va face extensia noastră de căutare Mactuts +. O să vă las să decideți ce să scrieți.

Pasul 2


De asemenea, va trebui să actualizăm versiunea, deoarece aceasta este prima extensie Mactuts înregistrată vreodată!

Acum, deoarece aceasta este prima dată când vom crea această extensie, să o facem versiunea 1. Localizați numărul versiunii din partea de sus a fișierului și schimbați-l de la 2 la 1.

S-ar putea să fi observat că, spre deosebire de numele extensiei, aceasta este ceva numit a Întreg si nu Şir. Integer înseamnă doar că specificați un număr, deci nu există litere sau caractere speciale.

Pasul 3


Identificatorul trebuie modificat deoarece este unic pentru fiecare extensie și dezvoltator

Fiecare extensie necesită un mod unic de identificare. Mai degrabă decât numele său, utilizează un identificator special care arată ca un nume de domeniu scris în sens invers. În acest cod sursă, o veți vedea scrisă după cum urmează:

com.pilotmoon.popclip.extension.google-translate

Schimbați acest lucru la următoarele:

com.mactuts.extension.mactuts-căutare

Chiar dacă am schimba numele extensiei, PopClip ar fi în continuare confuz dacă am fi instalat în același timp extensia noastră și extensia Google Traducere.

Pasul 4

Acum este momentul să controlați modul în care extensia funcționează. Extensia noastră va căuta Mactuts + pentru textul pe care l-ați selectat. Pentru a face acest lucru, trebuie să știm ce este adresa noastră de căutare.

Deschideți o nouă filă sau o fereastră cu Mactuts + încărcate și căutați cuvântul cheie "TEST". După ce căutarea este completă, aruncați o privire la bara de adrese. Ar trebui să vedeți următoarea adresă:

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

Din aceasta, putem vedea că adresa de căutare este:

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

Puteți testa acest lucru introducând adresa de mai sus și apoi orice cuvânt cheie dorit în bara de adrese a browserului dvs. După încărcarea paginii, veți vedea căutarea dorită.

PopClip utilizează textul popclip text ca substituent pentru textul pe care l-ați selectat. Ceea ce înseamnă că adresa de căutare pentru extensia noastră va fi:

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


Acum vom schimba URL-ul pe care se deschide PopClip (cu textul selectat) pentru a căuta Mactuts+

Această adresă de căutare este cea care va conduce extinderea. În fișierul Config, schimbați Şir care este sub secțiunea pentru URL- la cele de mai sus.

Pasul 5


Icoana noastră pe care o folosește PopClip trebuie să fie un pătrat de 256px, cu un fundal transparent și o zonă solidă în negru

Cu configurarea funcției principale de căutare, trebuie să adăugăm o pictogramă. Pictograma trebuie să fie un PNG transparent de 256 pixeli. Pentru a economisi timp, am inclus unul cu fișierul sursă pe care îl puteți descărca și utiliza.

Adăugați această pictogramă (sau propria dvs.) la dvs. mactuts pliant. Am numit pictograma pe care am furnizat-o MactutsIcon.png.


După ce adăugăm o nouă imagine, trebuie să actualizăm fișierul Config cu noul nume

Înapoi la fișierul Config, trebuie să schimbăm numele Fișier imagine la cel pe care îl folosim acum.

Pasul 6


În cele din urmă, modificați titlul extensiei și eliminați "cheia" și "șirul" pentru "expresie regulată"

Modificați titlul pop-up-ului de la "Traduceți" la "Mactuts +". În plus, eliminați Cheie și Şir în legătură cu Expresie uzuala. Aceasta este o opțiune suplimentară pe care nu o cerem.

Pasul 7

Prelungirea noastră este acum pregătită. Pentru a începe să o folosim, trebuie să îl convertim într-o extensie PopClip. Toate extensiile PopClip sunt de fapt foldere special numite. Nu există niciun instrument de conversie sau trickery de linie de comandă.


Duplicați folderul cu care lucrăm și redenumiți-l, adăugând ".popclipext" la sfârșit

Mai întâi duplicați dosarul. Cu folderul nou duplicat, redenumiți-l la mactuts.popclipext. Finder vă va cere să confirmați că doriți să îl redenumiți.


Veți fi întrebat dacă sunteți sigur că doriți să adăugați o extensie de fișier în dosarul duplicat

4. Instalați și testați extensia


PopClip va avertiza că această extensie nu este semnată, ceea ce înseamnă că nu a fost aprobată de dezvoltator. Deoarece este nou, e ok

După ce ați făcut conversia, faceți dublu clic pe fișierul de extensie nou creat pentru a instala. Veți primi un avertisment de la PopClip, explicând că aceasta nu este o extensie aprobată. Nu vă faceți griji, aceasta înseamnă doar că dorim să instalăm o extensie care nu a fost de pe site-ul dezvoltatorului. Confirmați că doriți să-l instalați și apoi extensia se va instala. Odată instalat, îl veți vedea în lista de extensii pe care PopClip le-a activat. În partea de jos a listei va fi noua extensie Mactuts +!


Odată instalat, PopClip va afișa noua noastră extensie în meniu

Acum, pentru a testa afară. Evidențiați niște text oriunde și când apare PopClip, ar trebui să vedeți acum butonul nostru de căutare Mactuts +.


Selectarea textului va afișa meniul PopClip ... împreună cu noua noastră extensie!

Dând clic pe acesta, se va deschide o nouă filă sau o fereastră (sau chiar se va lansa) browserul dvs. implicit și se va deschide direct pe pagina cu rezultatele căutării pentru ceea ce ați selectat.


Când este selectată, PopClip va deschide o filă nouă cu textul selectat căutat pe Mactuts+

Înfășurarea în sus

Până la sfârșitul acestui tutorial, sper că ați reușit să învățați multe din el și să începeți să construiți extensii mai avansate. Pagina dezvoltatorului de extensii PopClip de pe GitHub vă oferă cod sursă pentru toate tipurile de extensii, astfel încât să puteți vedea exact cum funcționează.

Deoarece construirea unei extensii pentru PopClip poate fi incredibil de ușoară, este posibil să nu fie nevoie să așteptați ca cineva să dezvolte o extensie pe care ați așteptat-o, ați putea să o construiți pentru dvs.!