Skip to content

UNITY_PACKAGES.md

Latest commit

 

History

History
66 lines (49 loc) · 2.84 KB

UNITY_PACKAGES.md

File metadata and controls

66 lines (49 loc) · 2.84 KB
Raw

Пакеты Unity и npm

Каждый репозиторий Arkvory — npm-совместимый реестр по адресу https://<host>/npm/<repository>/. Unity Package Manager подключает его как scoped registry, npm публикует в него пакеты. Решение и границы — ADR 0066.

Подключение в проекте Unity

Packages/manifest.json проекта:

{
  "scopedRegistries": [
    {
      "name": "Arkvory",
      "url": "https://arkvory.example/npm/games/",
      "scopes": ["com.proanima"]
    }
  ],
  "dependencies": {
    "com.proanima.tools": "1.2.0"
  }
}

scopes — префиксы имён пакетов, которые Unity берёт из Arkvory; остальные пакеты по-прежнему идут из реестра Unity.

Ключ доступа хранится не в проекте, а в пользовательском .upmconfig.toml (Windows: %USERPROFILE%\.upmconfig.toml, macOS и Linux: ~/.upmconfig.toml):

[npmAuth."https://arkvory.example/npm/games/"]
token = "<ключ Arkvory>"
alwaysAuth = true

Для разработчиков подходит персональный токен только для чтения, для сборочных агентов — сервисный ключ. Окно Package Manager → My Registries показывает пакеты реестра.

Публикация

В каталоге пакета (рядом с его package.json) — .npmrc:

registry=https://arkvory.example/npm/games/
//arkvory.example/npm/games/:_authToken=${ARKVORY_TOKEN}
npm publish
npm publish --tag beta
npm dist-tag add com.proanima.tools@1.3.0 latest
  • Версия неизменяема: исправление публикуется следующей версией.
  • Повтор той же публикации после обрыва безопасен.
  • Для публикации нужны права записи в репозиторий.
  • Имена пакетов Unity — обратный домен в нижнем регистре (com.company.package); @scope Unity не поддерживает, а npm-клиенты — да.

Что учесть

  • Большие бинарные ассеты, которые часто меняются, удобнее держать в Git LFS, а в пакетах — код и стабильные ресурсы.
  • Установку можно направить на шлюз чтения или зеркало; публикация — только на основной шлюз.
  • Удаления версий нет: проекты закрепляют версии, и удаление сломало бы их сборки.