Online Package Manager/ru

From Free Pascal wiki
Revision as of 10:10, 12 October 2019 by Zoltanleo (talk | contribs) (→‎Create)
Jump to navigationJump to search

Template:Translate

О плагине

Online Package Manager(OPM) - это инструмент, который автоматизирует процесс установки, обновления и настройки пакетов Lazarus. Пакеты хранятся в главном хранилище (см. столбец хранилища) в виде zip-файлов вместе с файлом JSON. JSON содержит всю необходимую информацию о пакетах. По запросу пакеты загружаются/извлекаются/компилируются/устанавливаются в IDE. Если доступно, также возможно обновить ранее установленный пакет с веб-страницы разработчика (см. столбец обновления). Здесь также есть веб-версия репозитория пакетов Lazarus.

Пожалуйста, имейте ввиду:

OPM читает описание пакета из файла lpk. Я могу понять, что описание многих пакетов очень минималистично или вообще отсутствует, но я ничего не могу с этим поделать. Не разрешается изменять описание пакета или любое другое свойство в этом отношении без согласия на то разработчика пакета. Более того протестировать каждый пакет, а затем написать подробное описание просто нереально.

Screenshot

OPM6.png

OPM7.png

License

GNU General Public License

Загрузка

Online package manager является частью исходников Lazarus, расположен в каталоге ($LazarusDir)/components/onlinepackagemanager.

Системные требования / зависимости

  • FPC 3.0.0 или новее
  • Lazarus 1.8 или новее
  • Вы можете скачать старую версию для серии 1.6: OPM 1.6
  • Эти версии были доступны на момент написания этого обновления.
  • Проверено на следующем наборе виджетов: win32/64, gtk2, carbon, qt(win)
  • Менеджер пакетов не имеет зависимости ни от одного внешнего пакета

Установка

В окне Lazarus "Install/Uninstall Packages" выберите «OnlinePackageManager» из списка доступных пакетов, нажмите «Install selection» и затем пересоберите IDE.

Страница поддержки

http://forum.lazarus.freepascal.org/index.php/topic,34297.0.html

Использование менеждера пакетов

Как начать

Перейдите в Lazarus Menu⇒Package(Пакет)⇒Online Package Manager(Сетевой диспетчер пакетов) (горячие клавиши: Ctrl+Alt+ Shift+O). При запуске менеджер пакетов автоматически загрузит список доступных пакетов из репозитория, который отображается в виде дерева (см. скриншоты выше).

Фильтрация дерева/Поиск пакетов

OPM3.png

Вы можете отфильтровать список пакетов по:

  • имени пакета
  • файлу пакета(.lpk)⇒пакет репозитория может содержать несколько файлов lpk
  • категории пакета
  • статусу пакета
  • версии
  • описанию
  • автору
  • совместимостью с версией Lazarus
  • совместимостью с версией FPC
  • поддерживаемым виджетсетам
  • типу пакета
  • зависимостям
  • виду лицензии

Действия с пакетами

OPM4.png

Обновление списка пакетов

Нажмите кнопку "Refresh"(Обновить), чтобы обновить список пакетов.

Загрузка пакета

Отметьте один или несколько пакетов, затем нажмите кнопку "Download"(Скачать). Это позволит загрузить/извлечь пакеты в предварительно выбранный каталог. Установлено ничего не будет. Бывает полезно, когда вы хотите установить пакеты вручную или изучить их исходники без установки.

Установка пакета

Отметьте один или несколько пакетов, затем нажмите кнопку "Install"(Установить). Менеджер пакетов автоматически загрузит/извлечет/скомпилирует/установит выбранные пакеты (из основного репозитория), а затем при необходимости пересоберет IDE (пакеты Designtime/Designtime_and_runtime). Подтвердите пересборку среды, нажав кнопку "Yes". Обратите внимание: функция компиляции доступна только начиная с версии Lazarus 1.7+.

Обновление пакета

Пометьте один или несколько пакетов, затем нажмите кнопку "Update"(Обновить). Менеджер пакетов обновит выбранные пакеты с домашней страницы разработчика(если доступно). Пакет сначала должен быть установлен, хотя прямое обновление возможно, но не допускается дабы предотвратить ошибку неразрешенной зависимости.
Обратите внимание: загрузка/установка пакета по внешней ссылке не лишена риска. Обновляйте пакет, только если вы доверяете разработчику пакета.

Различие между загрузкой/установкой/обновлением

Загрузка/установка -> Операция между вами и основным хранилищем.

Обновление -> Операция между вами и разработчиком пакета.

OPM10.png

Видеоссылка: Различие между загрузкой/установкой/обновлением

Очистка локального хранилища

Эта операция удалит все неустановленные пакеты/архивы из локального репозитория. Чтобы очистить локальный репозиторий, нажмите кнопку "Cleanup"(Очистить).

Создание

Этот раздел предназначен для разработчиков. Сначала вы должны перейти в Options(Параметры)⇒Profiles(Профили) и выбрать package maintainer(сопровождающий/разработчик пакета).

Создание репозитория пакета

Для создания репозитория пакета нажмите пункт меню "Create repository package"(Создать репозиторий пакета), затем:

  • выберите основной каталог пакета (менеджер пакетов будет рекурсивно искать все файлы пакета внутри папки)
  • выберите репозиторий пакета(корневой узел)
    • выберите категорию (обязательно)
    • введите отображаемое имя (необязательно)
    • домашняя страница (необязательно)
    • обновите ссылку(необязательно, подробности см. ниже в разделе Создание JSON для обновлений).
    • создайте JSON для обновлений(необязательно), имеет те же функции, что и диалоговое окно Создание JSON для обновлений. Он также был добавлен сюда для ускорения процесса.

OPM15.png

  • пометьте каждый пакет, который вы хотите включить, при необходимости измените информацию о пакете (совместимость с lazarus/fpc, поддерживаемый набор виджетов и т.д.)

OPM16.png

  • нажмите кнопку "Create"(Создать), если все пойдет хорошо, вы должны получить zip и json файл. Загрузите куда-нибудь файлы и отправьте ссылку на getmem1@gmail.com или
  • нажмите кнопку "Submit"(Отправить), файлы будут напрямую загружены на удаленный сервер. Каждый пакет будет принят после короткой проверки (вредоносная программа, лицензия и т.д.).

Также допускает отправка нескольких версий одного и того же пакета.

Создание JSON для обновлений

To allow the user to update the package directly form your webpage, follow this steps:

  • Check the package, press the "Create JSON for upates" menu item then create the JSON.

OPM11.png

  • Edit the JSON, upload to your webpage, then send me the link.

The JSON will look like this:

OPM12.png

Editable items in the JSON:

"DownloadZipURL" --> Link to your new, updated package

"DisableInOPM" --> If you want to temporary disable your package, set this boolean to true. It's useful for maintenance, the package will be grayed out in the tree. The user cannot download/install/update the package.

"Version"/"ForceNotify"/"InternalVersion" --> To trigger an update message on the users computer, you can either:

  • Increase the "Version" number. Useful when you want to release a new version of the package.
  • Set "ForceNotify" to true. Useful after a minor change in your source, that does not require a version change or in case of trunk version. To prevent continous error messages, "ForceNotify" must be used in combination with "InternalVersion". After the user updates the package, OPM locally stores the "InternalVersion" value. If you want to trigger a new message, increase "InternalVersion" with one. If "ForceNotify" is true, "Version" is always ignored.

The most common scenario is this:

  • Generate the JSON
  • Modify "DownloadZipURL"
  • Increase version number when necessary.

Please note: After you edited the JSON the changes are not immediately visible in the tree. Usually it takes 1-2 min. It also depends on the users setting(Options-->General-->Check for package updates).

Options

To display the options dialog press the "Options" button.

Create a private repository

In order to create a private repository please do the following:

1. First make sure profile "Package maintainer" is enabled in Options-->Profiles, then open the private repository form(see screenshot below)

OPM17.png


2. Press the "Create" button. Enter repository Name, Address(optional), Description(optional). Save the repository to an empty folder

OPM18.png


  • If filled, the repository address(in this case http://localhost/packages/) is automatically added to available repository list(Options form)

OPM19.png


3. Start to add/delete packages. You have two choices:

a. Create a new package via http://wiki.freepascal.org/Online_Package_Manager#Create_repository_package

b. Add a previously saved package

OPM20.png


4.You can also open a previously saved repository. The last repository is automatically opened on startup.

5.Upload the files(packagelist.json, *.zip) to your local or remote server.

6.Make sure the server is running, the change "Remote repository" in Options-->General

see also