Crea la tua estensione personalizzata per PopClip

PopClip è una delle nostre app preferite su Mactuts + e uno dei motivi per cui è il supporto per le estensioni. Puoi eseguire azioni sul testo selezionato utilizzando PopClip che lo rende estremamente versatile, sia che tu voglia aprire un link in un altro browser, cercare il testo selezionato in Google o aggiungerlo come una cosa da fare alle Cose, PopClip fornisce uno stile iOS menu a comparsa che semplifica queste attività.

In questo tutorial, dimostrerò quanto sia facile creare il tuo estensione per PopClip per eseguire un'azione personalizzata.


Cos'è PopClip?


PopClip fornisce un menu in stile iOS che può essere ulteriormente personalizzato con estensioni

PopClip ($ 4,99) è un'applicazione per OS X che fornisce un menu a comparsa simile a iOS quando si seleziona il testo. L'uso principale è per tagliare, copiare e incollare - ancora una volta, molto simile a iOS. Dove diventa davvero interessante è la possibilità di installare estensioni per fare molto di più che aggiungere agli Appunti.

Al momento della scrittura, ci sono state oltre 92 estensioni disponibili per il download gratuito. Queste estensioni spaziano dall'apertura di un collegamento in Google Chrome, al post di testo selezionato su Facebook, all'aggiunta di virgolette sul testo selezionato e altro ancora.

Mancia: Ci sono molte estensioni e ti invito a dare un'occhiata, che puoi trovare nella pagina di estensione di PopClip.

Uso PopClip regolarmente e uso un'estensione per aggiungere testo selezionato a Things, la mia app to-do preferita.


Come sono costruiti

PopClip supporta le estensioni scritte in diversi modi:

  • Servizio Mac OS X.
  • AppleScript
  • Script di Shell
  • URL
  • keypress

Tutti e due URL e keypress non richiede conoscenze di programmazione per crearli. Se conosci l'URL di un sito che può includere del testo o premere una determinata combinazione di tasti, puoi creare la tua estensione personale.

I restanti tre vengono creati utilizzando scripting le lingue. Possono manipolare il testo in un modo più avanzato. Ai fini di questo tutorial, creerò un'estensione usando il URL metodo.

UN URL l'estensione richiede solo due file, il nostro file di configurazione delle estensioni e un'icona da visualizzare all'interno del menu a comparsa quando selezioniamo del testo.


Costruire il nostro

C'è una grande selezione di estensioni che possiamo usare, ma potrebbe non esserne una adatta alle nostre esigenze. Ad esempio, ti mostrerò come creare un'estensione PopClip in grado di effettuare ricerche su Mactuts + per il testo selezionato.

Per fare questo, non ti mostrerò come costruirne uno da zero ma, invece, utilizzeremo alcuni dei codici di esempio forniti dallo sviluppatore e apporteremo modifiche ad esso per soddisfare le nostre esigenze. Questo ti darà una buona idea di come funziona l'estensione e di quali modifiche avremmo bisogno per iniziare a creare le nostre estensioni.

Suggerimento: per apportare modifiche è sufficiente un editor di testo. TextEdit non è l'ideale per la modifica del codice, quindi consiglierei qualcosa come TextWrangler che non è solo un'ottima app ma è anche gratis!


1. Creare una cartella


Puoi creare questa cartella ovunque, poiché sarà solo un posto dove lavorare per ora

Sul desktop (o dove vuoi), crea una cartella chiamata mactuts. Qui è dove archiviamo i nostri file di estensione prima di trasformarli in un'apposita estensione di PopClip.


2. Scarica il codice sorgente

Nel sito per gli sviluppatori di PopClip Extension, siamo in grado di scaricare alcuni esempi di codice sorgente. Sotto la voce Panoramica generale, vedrai i tipi di azioni supportati da PopClip. Vogliamo scaricare il codice di esempio per URL azione, che è il codice sorgente per il Google Traduttore estensione.

Vedrete due file all'interno della vista, il Config.plist e TranslationIcon.png. Ci interessa solo il file di configurazione.


Ecco come appare il codice quando viene aperto / incollato in un editor di testo (in questo caso, TextMate)

Il file di configurazione principale di un'estensione è noto come a Elenco delle proprietà file, altrimenti noto come a plist. Potresti averne sentito parlare perché è lo stesso tipo di file che OS X utilizza per memorizzare le preferenze per le applicazioni. Si basa su un formato noto come XML. Prenditi qualche minuto per familiarizzare con il formato.

Sembra familiare? XML è progettato per funzionare in modo simile a HTML, il linguaggio di markup usato per costruire pagine web.

Mancia: Se desideri saperne di più sugli elenchi di proprietà, la Developer Library di Apple ha un ottimo articolo introduttivo che puoi leggere

Se non conosci GitHub, puoi scaricare direttamente l'estensione. (Fare clic con il tasto destro del mouse sul collegamento e selezionare Scarica file come ... , salvandolo sul mactuts cartella che abbiamo creato in precedenza).


3. Modifichiamo!

Ormai dovresti aver salvato il Config.plist file al tuo mactuts cartella. Modifichiamo quel file all'interno di un editor di testo.

Come hai visto, questo file ha un numero di diverse opzioni configurabili. Noterai che un'opzione è chiamata a Chiave. Questi dicono a PopClip che l'estensione è in grado di fornire determinate informazioni. Non cambieremo nessuno chiavi, ma invece modificheremo le informazioni all'interno.

Passo 1


La prima cosa che cambieremo è il nome e la descrizione dell'estensione

Prima di tutto, dobbiamo cambiare il nostro Nome estensione e Descrizione dell'estensione. Trova la linea che ha il chiave per questo e cambia il nome che si trova nella stringa sottostante, attualmente scritto come "Google Traduttore" di conseguenza. Ricorda, non cambiare la chiave.

Ora che hai cambiato il nome dell'estensione, cambiamo la descrizione per riflettere meglio ciò che fa. Usando gli stessi passi come sopra, cambia la descrizione per descrivere meglio cosa farà la nostra estensione di ricerca Mactuts +. Lo lascerò a te per decidere cosa scrivere.

Passo 2


Dovremo inoltre aggiornare la versione poiché questa è la prima estensione di Mactuts di sempre!

Ora, poiché questa è la prima volta che creeremo questa estensione, facciamola versione 1. Posiziona il numero della versione nella parte superiore del file e cambiala da 2 a 1.

Potresti aver notato che, a differenza del nome dell'estensione, questo è qualcosa chiamato an Numero intero e non Stringa. Integer significa semplicemente che stai specificando solo un numero, quindi niente lettere o caratteri speciali.

Passaggio 3


L'identificatore deve essere modificato in quanto è univoco per ogni estensione e sviluppatore

Ogni estensione ha bisogno di un modo unico di essere identificata. Piuttosto che usare il suo nome, usa un identificatore speciale che sembra un nome di dominio scritto al contrario. In questo codice sorgente, lo vedrai scritto come segue:

com.pilotmoon.popclip.extension.google-translate

Cambia questo al seguente:

com.mactuts.extension.mactuts-search

Anche se avessimo cambiato il nome dell'estensione, PopClip sarebbe ancora confuso se avessimo la nostra estensione e l'estensione Google Translate installata nello stesso momento.

Passaggio 4

Ora è il momento di controllare il funzionamento dell'estensione. La nostra estensione cercherà Mactuts + per il testo che hai selezionato. Per fare questo, abbiamo bisogno di sapere qual è il nostro indirizzo di ricerca.

Apri una nuova scheda o finestra con Mactuts + caricato e cerca la parola chiave "TEST". Una volta completata la ricerca, dai un'occhiata alla barra degli indirizzi. Dovresti vedere il seguente indirizzo:

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

Da questo, possiamo vedere che l'indirizzo di ricerca è:

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

Puoi verificarlo inserendo l'indirizzo precedente e quindi qualsiasi parola chiave che desideri nella barra degli indirizzi del browser. Una volta caricata la pagina, vedrai la ricerca che desideri.

PopClip utilizza il testo popclip text come segnaposto per il testo che hai selezionato. Ciò significa che l'indirizzo di ricerca per la nostra estensione sarà:

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


Ora cambiamo l'URL che PopClip apre (con il testo selezionato) per cercare i Mactuts+

Questo indirizzo di ricerca è ciò che alimenterà la nostra estensione. Nel file di configurazione, cambia il Stringa quello è sotto la sezione per URL a quanto sopra.

Passaggio 5


La nostra icona utilizzata da PopClip deve essere di 256 px quadrati con uno sfondo trasparente e un'area solida in nero

Con la funzione di ricerca principale configurata, è necessario aggiungere un'icona. L'icona deve essere un PNG trasparente a 256 pixel quadrato. Per risparmiare tempo, ne ho incluso uno con il file sorgente che puoi scaricare e utilizzare.

Aggiungi questa icona (o la tua) al tuo mactuts cartella. Ho chiamato l'icona che ho fornito MactutsIcon.png.


Una volta aggiunta una nuova immagine, è necessario aggiornare il file di configurazione con il nuovo nome

Torna al file di configurazione, abbiamo bisogno di cambiare il nome del File immagine a quello che stiamo usando ora.

Passaggio 6


Infine, cambia il titolo dell'estensione e rimuovi la "chiave" e la "stringa" per "Espressione regolare"

Cambia il titolo del pop-up da "Traduci" a "Mactuts +". Inoltre, rimuovere il Chiave e Stringa collegato a Espressione regolare. Questo è un extra opzionale che non richiediamo.

Passaggio 7

La nostra estensione è ora pronta per andare. Per iniziare a usarlo, dobbiamo convertirlo in un'estensione PopClip. Tutte le estensioni PopClip sono in realtà solo cartelle con nomi speciali. Non ci sono strumenti di conversione o trucchi da riga di comando da fare.


Duplica la cartella con cui abbiamo lavorato e rinominala, aggiungendo ".popclipext" alla fine

Prima di tutto duplica la cartella. Con la cartella appena duplicata, rinominala in mactuts.popclipext. Il Finder ti chiederà di confermare la tua intenzione di rinominarlo.


Ti verrà chiesto se sei sicuro di voler aggiungere un'estensione di file alla cartella duplicata

4. Installa e verifica l'estensione


PopClip avverte che questa estensione non è firmata, il che significa che non è stata approvata dallo sviluppatore. Come è nuovo di zecca, va bene

Una volta convertito, fare doppio clic sul file di estensione appena creato per l'installazione. Riceverai un avviso da PopClip che spiega che questa non è un'estensione approvata. Non preoccuparti, questo significa solo che stiamo installando un'estensione che non proviene dal sito Web dello sviluppatore. Conferma che desideri installarlo e quindi l'estensione verrà installata. Una volta installato, lo vedrai nell'elenco delle estensioni che PopClip è attivo. In fondo alla lista ci sarà l'estensione Mactuts + appena sviluppata!


Una volta installato, PopClip mostrerà la nostra nuova estensione nel menu

Ora per testarlo. Evidenzia un po 'di testo ovunque e quando appare PopClip, ora dovresti vedere il nostro pulsante di ricerca Mactuts +.


Selezionando il testo verrà visualizzato il menu PopClip ... insieme alla nostra nuova estensione!

Cliccando si aprirà una nuova scheda o finestra (o addirittura si avvia) il browser predefinito e si aprirà direttamente alla pagina dei risultati di ricerca per ciò che hai selezionato.


Quando selezionato, PopClip aprirà una nuova scheda con il testo selezionato cercato su Mactuts+

Avvolgendo

Alla fine di questo tutorial, mi auguro che tu abbia potuto imparare molto da esso e iniziare a creare estensioni più avanzate. La pagina degli sviluppatori di estensioni di PopClip su GitHub ti fornisce il codice sorgente per tutti i tipi di estensioni in modo che tu possa vedere esattamente come funzionano.

Dal momento che la creazione di un'estensione per PopClip può essere incredibilmente facile, potresti non aver bisogno di aspettare che qualcuno sviluppi un'estensione che stavi aspettando, potresti essere in grado di costruirla per te stesso!