Статьи

Введение в интерфейс командной строки Firefox OS

Firefox OS (мы будем называть FFOS) — это новая мобильная операционная система, обладающая большим потенциалом и растущая популярность среди пользователей и разработчиков.

После разработки нескольких приложений FFOS, я думаю, процесс мог бы быть более автоматизированным и менее повторяющимся. Должен быть более быстрый способ создания проекта, чем создание вручную всего дерева каталогов и необходимых файлов для каждого приложения FFOS.

Вдохновленный Git, я решил создать интерфейс командной строки, чтобы автоматизировать процесс и помогать другим разработчикам, которым нравится разрабатывать приложения FFOS.

Что такое ффос-кли?

ffos-cli Это поможет вам сгенерировать все дерево каталогов, необходимое для приложения FFOS и многое другое.

Это помогает разработчику:

  • Создайте новую папку проекта с названием приложения
  • Отредактируйте файл манифеста из командной строки
  • Добавить исходные файлы в проект

Начиная

ffos-cli использует библиотеку C, которая называется jansson , для работы с файлами JSON, такими как файл manifest.webapp Чтобы получить ffos-clijansson . Если вы используете Ubuntu, сделайте это, выполнив:

 sudo apt-get install libjansson-dev

Если вы используете Mac, вы можете использовать Homebrew и набрать:

 brew install jansson

Это установит jansson на вашу машину. Теперь вы готовы получить исходный код ffos-cli Вы можете клонировать исходный код из GitHub .

Чтобы клонировать его на свой компьютер, выполните:

 git clone https://github.com/aziflaj/ffos-cli.git

И установить, выполнить:

 cd ffos-cli
make
sudo make install

Если вы выполните ffos

 ffos-cli 0.1 to help developing Firefox OS applications easier

commands:
    create - Creates a new Firefox OS application folder with necessary files
    add - Adds new source files to the working project
    set - Changes data stored in manifest file

For more help check the README or type ffos help [command].

Если вы видите эту страницу справки (я уверен, что вы это сделаете), вы успешно установили ffos-cli Теперь вы готовы создавать приложения для Firefox OS, используя его.

ффос-кли в действии

Теперь давайте использовать этот инструмент для создания и управления приложением Firefox OS.

Чтобы создать приложение, выполните:

 ffos create MagnApp

Эта команда создаст следующее дерево каталогов:

 [MagnApp]
    |------ css/
    |------ img/
    |------ js/
    |------ index.html
    |------ manifest.webapp

Перейдите в каталог MagnApp и настройте файл manifest.webapp.

По умолчанию файл manifest.webapp

 {
    "name" : "MagnApp",
    "launch_path" : "index.html",
    "description" : "App description here",
    "version" : "1.0",
    "developer" : {
        "name" : "Your name here",
        "url" : "Your url here"
    }
}

Если вы хотите установить свое имя или название своей компании в качестве имени разработчика или свой URL-адрес в качестве URL-адреса разработчика, вы можете выполнить:

 ffos set dev.name John Doe                  # or your company name
ffos set dev.url https://www.johndoe.com    # or your company url

Теперь давайте изменим описание разрабатываемого приложения. Это можно сделать, выполнив:

 ffos set descr "This application does magnificient things"

Может быть, вы не выпускаете это приложение как версия 1.0. Чтобы изменить номер версии, выполните это:

 ffos set version 0.3    # or whatever version this is

После выполнения всех этих команд ffosmanifest.webapp

 {
    "name" : "MagnApp",
    "launch_path" : "index.html",
    "description" : "This application does magnificient things",
    "version" : "0.3",
    "developer" : {
        "name" : "John Doe",
        "url" : "https://www.johndoe.com"
    }
}

Если вам нужно добавить файлы CSS и JavaScript в ваш проект. Вы можете создать их вручную или выполнить:

 ffos add css main   # this creates main.css
ffos add js app     # this creates app.js

После их выполнения дерево каталогов становится:

 [MagnApp]
    |------ css/
    |          |------ main.css
    |
    |------ img/
    |
    |------ js/
    |          |------ app.js
    |
    |------ index.html
    |------ manifest.webapp

Вы можете добавить больше html-файлов, выполнив (вы, наверное, уже поняли это!):

 ffos add html anotherfile   # this creates anotherfile.html

Если вы хотите установить anotherfile.html

 ffos set launch_path anotherfile.html

Во время разработки вашего приложения вам может потребоваться добавить разрешения. Разрешения — это поля в манифесте, которые содержат информацию о конкретных API, которые используются приложением. Это список всех разрешений, принятых Mozilla, в файле manifest.webapp Чтобы добавить разрешение с помощью ffos-cli

 ffos set permission alarms "This application will use alarms"

Эта команда добавляет разрешение под названием "alarms""This application will use alarms" Если в файле "alarms"manifest.webapp

Итак, при условии, что вы выполнили все команды выше, у вас будет это дерево каталогов:

 [MagnApp]
    |------ css/
    |          |------ main.css
    |
    |------ img/
    |
    |------ js/
    |          |------ app.js
    |
    |------ anotherfile.html
    |------ index.html
    |------ manifest.webapp

и файл manifest.webapp

 {
    "name" : "MagnApp",
    "launch_path" : "anotherfile.html",
    "description" : "This application does magnificient things",
    "version" : "0.3",
    "developer" : {
        "name" : "John Doe",
        "url" : "https://www.johndoe.com"
    },
    "permissions" : {
        "alarms" : {
            "description" : "This magnificient application will use alarms"
        }
    }
}

Простота была первой вещью в моей голове, когда я проектировал и разрабатывал ffos-cli, и я надеюсь, что вы найдете это полезным. Не стесняйтесь раскошелиться на GitHub . В настоящий момент я думаю, что функции фильтрации разрешений и упаковки приложений были бы полезны и хотели бы получить вашу помощь, добавив эти или любые другие функции, которые вы считаете необходимыми.