Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.
Prerequisites
To develop with the Add-on SDK, you'll need:
- Python 2.5, 2.6 or 2.7. Note that versions 3.x of Python are not supported on any platform. Make sure that Python is in your path.
- Firefox.
- The SDK itself: you can obtain the latest stable version of the SDK as a tarball or a zip file.
Alternatively, if you use Firefox Nightly, you can get the latest development version from its GitHub repository.
Installation on Mac OS X / Linux
Extract the file contents wherever you choose, and navigate to the root directory of the SDK with a shell/command prompt. For example:
tar -xf addon-sdk.tar.gz cd addon-sdk
Then run if you're a Bash user (most people are):
source bin/activate
And if you're a non-Bash user, you should run:
bash bin/activate
Your command prompt should now have a new prefix containing the name of the SDK's root directory:
(addon-sdk)~/mozilla/addon-sdk >
Installation on Mac using Homebrew
If you're a Mac user, you can instead choose to use Homebrew to install the SDK, using the following command:
brew install mozilla-addon-sdk
Once this has completed successfully, you can use the cfx
program at your command line at any time: you don't need to run 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.
Problems?
Try the Troubleshooting page.
Next Steps
Next, take a look at the Getting Started With cfx tutorial, which explains how to create add-ons using the cfx
tool.