license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.

Руководство для платформы Firefox OS

В этом руководстве показано, как настроить вашу среду разработки для развертывания приложений Cordova на устройствах Firefox OS, а также тестировать и опубликовывать эти приложения.

Требования и поддержка

Firefox OS приложения являются просто веб-приложениями, с добавлением файла manifest.webapp, который определяет метаданные о приложении и позволяет ему быть установленым на устройстве Firefox OS. Любая платформа которую поддерживает Cordova может быть использована.Чтобы узнать больше о создании веб-приложений, обратитесь в App Center на MDN.

Установка и настройка среды

Сначала установить Node.js, а затем установить пакет Cordova следующим образом:

$ npm install -g cordova

Далее создайте тестовое приложения Cordova, а затем перейдите в созданную директорию:

$ cordova create test-app
$ cd test-app

Добавьте Firefox OS как поддерживаемую платформа в приложение следующим образом:

$ cordova platform add firefoxos

Это создает приложение Firefox OS в каталоге platforms/firefoxos/www, который в настоящее время выглядит так же как и каталог www, за исключением того, что он содержит файл манифеста Firefox (manifest.webapp) внутри директории www.

Разработка вашего приложения

На данный момент вы готовы к работе — изменить код внутри test-app/www на все, что вы хотите. Вы можете добавить поддерживаемые плагины в приложение, с помощью «cordova plugin add», например:

cordova plugin add cordova-plugin-device
cordova plugin add cordova-plugin-vibration

Когда написан код приложения, развертывайте ваши изменений в Firefox OS приложении, которые вы добавили в в проект с помощью

$ cordova prepare firefoxos

Для создания упакованного приложения можно архивировать каталог platforms/firefoxos/www. Вы можете также просто построить его с помощью

$ cordova build firefoxos

Упаковонное приложение Firefox OS будет собрано в platforms/firefoxos/build/package.zip

Тестирование и отладка

Приложение может быть протестировано с помощью Firefox OS Web IDE.

Когда вы подключените App Manager к вашему тестовому устройству/симулятору, выберите параметр «Add Packaged App», то убедитесь, что вы указываете на каталог test-app/platforms/firefoxos/www/ для включения приложения в интерфейсе App Manager.

Здесь можно установить приложение на ваше тестовое устройство/симулятор (с кнопкой «Update»). С помощью кнопки «Debug» можно выполнить отладку приложения и отредактировать его код по живому.

Примечание: Прежде чем публиковать приложение вы должны проверить его с помощью App validator.

Публикация приложения в Firefox Marketplace

Можно отправить ваше приложение в Firefox Marketplace или опубликовать его самостоятельно. Посетите Зону Firefox Marketplace на MDN, чтобы узнать больше о том, как сделать это; Параметры публикации App является лучшим местом для начала.