Docs
Разработка
Разработка пакета

Разработка пакета

Разработка пакета #

Есть два варианта:

  • Просто поставить пакет на роутер или виртуалку и прямо редактировать через SFTP (opkg install openssh-sftp-server)
  • SDK, чтобы собирать пакеты

Для сборки пакетов нужен SDK, один из вариантов скачать прям файл и разархивировать https://downloads.openwrt.org/releases/24.10.2/targets/x86/64/ Нужен файл в имени которого есть SDK

wget https://downloads.openwrt.org/releases/24.10.2/targets/x86/64/openwrt-sdk-24.10.2-x86-64_gcc-13.3.0_musl.Linux-x86_64.tar.zst
tar xf openwrt-sdk-23.05.5-x86-64_gcc-12.3.0_musl.Linux-x86_64.tar.xz
mv openwrt-sdk-23.05.5-x86-64_gcc-12.3.0_musl.Linux-x86_64 SDK

Последнее делается для удобства.

Создаём директорию для пакета

mkdir package/utilites

Симлинк из репозитория

ln -s ~/podkop/podkop package/utilites/podkop
ln -s ~/podkop/luci-app-podkop package/luci-app-podkop

В первый раз для сборки luci-app необходимо обновить и установить пакеты

./scripts/feeds update -a
./scripts/feeds install -a

Для make можно добавить флаг -j N, где N - количество ядер для сборки.

При первом make выводится меню, можно просто save, exit и всё. Первый раз долго грузит зависимости.

Сборка пакета. Сами пакеты собираются быстро.

make package/podkop/{clean,compile} V=s

Также для LuCi

make package/luci-app-podkop/{clean,compile} V=s

Оба сразу

make package/luci-app-podkop/{clean,compile} package/podkop/{clean,compile} V=s

.ipk находятся в bin/packages/x86_64/base/

Ошибки # 

Makefile:17: /SDK/feeds/luci/luci.mk: No such file or directory
make[2]: *** No rule to make target '/SDK/feeds/luci/luci.mk'.  Stop.
time: package/luci/luci-app-podkop/clean#0.00#0.00#0.00
    ERROR: package/luci/luci-app-podkop failed to build.
make[1]: *** [package/Makefile:129: package/luci/luci-app-podkop/clean] Error 1
make[1]: Leaving directory '/SDK'
make: *** [/SDK/include/toplevel.mk:226: package/luci-app-podkop/clean] Error 2

Не загружены пакеты для LuCi

Зависимости make #

https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem

Ubuntu

sudo apt update
sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Примеры ссылок-конфигураций #

https://github.com/itdoginfo/podkop/blob/main/String-example.md

Интернационализация (i18n) #

Интернационализация — это подготовка пакета к переводу на разные языки.

На этом этапе помечаются строки кода, подлежащие локализации с помощью gettext, и создаются шаблоны переводов .pot (Portable Object Template), которые затем используются для создания конкретных файлов перевода .po.

В LuCI функция gettext имеет алиас _, который чаще используется в коде для краткости, например:

let o = s.tab('basic', _('Basic Settings'));

Этапы создания или обновления шаблона перевода #

  1. Перейдите в поддиректорию luci-app-podkop проекта podkop.
cd luci-app-podkop
  1. Запустите скрипт генерации шаблона переводов:
./xgettext.sh

Скрипт соберёт все строки, помеченные с помощью _(), и создаст обновлённый шаблон перевода podkop.pot. Шаблон перевода podkop.pot будет находиться в соответствующей папке шаблонов, обычно po/templates/podkop.pot

После этого .pot можно использовать для создания или обновления файлов перевода .po для нужных локалей.

Локализация (l10n) #

Для локализации интерфейса podkop на выбранный язык используется дополнительный языковой пакет, например luci-i18n-podkop-ru.

Перед сборкой пакета следует обновить или создать файл перевода .po (Portable Object) для соответствующей локали.

Этапы создания или обновления перевода #

  1. Перейдите в поддиректорию luci-app-podkop проекта podkop.
cd luci-app-podkop
  1. Запуск скрипта обновления перевода

Для создания или обновления .po файла используйте скрипт msgmerge.sh с указанием кода локали, например:

./msgmerge.sh ru
  • Скрипт автоматически создаст новый .po файл, если его ещё нет, или объединит существующий файл перевода с обновлённым шаблоном .pot
  • .po файлы будут находиться в соответствующей папке локали, обычно po/<код_локали>/podkop.po
  1. Редактирование перевода

После выполнения скрипта откройте .po файл и переведите строки, помеченные как msgid, например:

msgid "Settings"
msgstr "Настройки"
  1. Проверка

Проверьте корректность .po файла:

msgfmt po/ru/podkop.po -o /dev/null --check

После этого необходимо зафиксировать изменения шаблона .pot и файлов перевода .po, после чего отправить их в репозиторий.

Редактирование документации