Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.
Prerequisiti
Per sviluppare con Add-on SDK hai bisogno di:
- Python 2.5, 2.6 o 2.7. Attenzione Python 3.x non è supportato in alcune piattaforme.
- Firefox.
- L'SDK stessa: si puo scaricare l'ultima versione stabile dell'SDK in formato tarball o zip.
L'ultima versione in sviluppo è presente nella repository su GitHub.
Costruire l'estensione per AMO
Solo l'ultima versione della tag verrà usata se presentata alla AMO.
The git archive command is needed to expand some git attribute placeholders.
git checkout 1.16 git archive 1.16 python-lib/cuddlefish/_version.py | tar -xvf -
Procedimento di installazione per Linux/ Mac OS X / FreeBSD
Utilizzando il terminale si estrarre il file contenenti nell'archivio dell'SDK e dopodichè si ci sposta nella cartella principale appena estratta.
Per esempio:
tar -xf addon-sdk.tar.gz cd addon-sdk
Se siete utenti Bash (molte persone lo sono) eseguire questo comando dal vostro terminale:
source bin/activate
se non funziona il comando precedente e/o non siete utensi Bash usate questo comando:
bash bin/activate
Dal vostro terminale dovrebbe aparire la stringa simile a questa contenente il nome della cartella dell'SDK, come per esempio:
(addon-sdk)~/mozilla/addon-sdk >
Installazione nel Mac usando Homebrew
Se siete utenti Mac, si può scegliere di utilizzare Homebrew per l'installazione dell'SDK, usando i seguenti comandi:
brew install mozilla-addon-sdk
Una volta che l'installazione è completata con successo, si può usare il programma cfx dal terminale in qualsiasi momento: senza dover eseguire bin/activate.
Installation on Windows
Extract the file contents wherever you choose, and navigate to the root directory of the SDK with a shell/command prompt. For example:
7z.exe x addon-sdk.zip cd addon-sdk
Then run:
bin\activate
Your command prompt should now have a new prefix containing the full path to the SDK's root directory:
(C:\Users\mozilla\sdk\addon-sdk) C:\Users\Work\sdk\addon-sdk>
activate
The activate command sets some environment variables that are needed for the SDK. It sets the variables for the current command prompt only. If you open a new command prompt, the SDK will not be active in the new prompt. until you type activate again.
This means that you can have multiple copies of the SDK in different locations on disk and switch between them, or even have them both activated in different command prompts at the same time.
Making activate permanent
By setting these variables permanently in your environment so every new command prompt reads them, you can make activation permanent. Then you don't need to type activate every time you open up a new command prompt.
Because the exact set of variables may change with new releases of the SDK, it's best to refer to the activation scripts to determine which variables need to be set. Activation uses different scripts and sets different variables for bash environments (Linux and Mac OS X) and for Windows environments.
Windows
On Windows, bin\activate uses activate.bat, and you can make activation permanent using the command line setx tool or the Control Panel.
Linux/Mac OS X
On Linux and Mac OS X, source bin/activate uses the activate bash script, and you can make activation permanent using your ~/.bashrc (on Linux) or ~/.bashprofile (on Mac OS X).
As an alternative to this, you can create a symbolic link to the cfx program in your ~/bin directory:
ln -s PATH_TO_SDK/bin/cfx ~/bin/cfx
If you used Homebrew to install the SDK, the environment variables are already set permanently for you.
Sanity check
Run this at your shell prompt:
cfx
It should produce output whose first line looks something like this, followed by many lines of usage information:
Usage: cfx [options] [command]
This is the cfx command-line program. It's your primary interface to the Add-on SDK. You use it to launch Firefox and test your add-on, package your add-on for distribution, view documentation, and run unit tests.
Ci sono problemi?
Prova la pagina per Risoluzione dei problemi.
Prossimo passo
Quindi, guardate la Guida introduttiva di CFX, che spiega come creare add-on utilizzando lo strumento CFX.