Установить Unity Package Manager CLI

Настройте интерфейс командной строки Unity Package Manager (UPM CLI), чтобы упаковывать и подписывать собственные пакеты из командной строки или из среды непрерывной интеграции (CI).

UPM CLI поддерживает те же платформы и архитектуры, что и Unity Editor.

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

Скрипт установки выполняется локально. Личные данные в Unity он не отправляет.

Справочную информацию о UPM CLI см. в Unity Package Manager CLI рабочем процессе.

Предварительные условия

Перед установкой и использованием UPM CLI выполните следующие действия.

Важно: Эти предварительные условия требуют взаимодействия с Unity Cloud Панель управления. Если вы принадлежите к нескольким организациям, убедитесь, что вы вошли в панель управления с организацией, с которой вы хотите подписать пакеты. Используйте меню учетной записи в панели управления, чтобы проверить свою организацию или изменить на другую организацию.

1. Создание учетной записи службы:
   • Следуйте инструкциям в Создание учетной записи службы.
   • При добавлении доступа к учетной записи службы на уровне организации выберите Управление ролями организации, перейдите в поле Package Manager и выберите Package Manager Подписчик пакета. Выберите Сохранить.
2. Хранить учетные данные учетной записи службы:
   • Установите следующие переменные среды (если вы запускаете скрипт локально) или в настройках секретов вашего инструмента CI (если вы запускаете скрипт в автоматизированной среде):
     • UPM_SERVICE_ACCOUNT_KEY_ID: ключ ID, созданный при создании учетной записи службы.
     • UPM_SERVICE_ACCOUNT_KEY_SECRET: секретный ключ, созданный при создании учетной записи службы.
3. Копировать вашей организации ID. Для подробностей см. Идентификация организации ID.
   • Команда pack требует это значение как часть процесса подписания.

Проверьте, уже ли установлен UPM CLI

Чтобы проверить, уже ли установлен UPM CLI:

1. Откройте окно терминала (macOS или Linux) или окно PowerShell (Windows).

2. Выполните одну из следующих команд:

   upm --version
   upm -v
   

3. Проверьте результаты:
   • Если команда возвращает ошибку типа command not found или 'upm' is not recognized, то UPM CLI не установлен. Перейдите к Установка UPM CLI.
   • Если команда возвращает номер версии, сравните его с последней версией, указанной в https://cdn.packages.unity.com/upm-cli/latest.txt. Если ваша версия устарела, перейдите к Установка UPM CLI для обновления. В противном случае перейдите к Пакет и подпишите пакет с Unity Package Manager CLI.

Установить UPM CLI

Вы можете установить или обновить до последней версии UPM CLI с одной командой, или вы можете запустить несколько команд, если вы хотите проверить скрипт.

Оба метода устанавливают UPM CLI и добавляют его к переменной среды PATH, так что вы можете запускать команды upm из любого каталога.

Установка одной командой

Чтобы загрузить и установить последнюю версию UPM CLI без проверки скрипта, запустите команду, соответствующую вашей операционной системе:

• macOS или Linux:

  curl -fsSL https://cdn.packages.unity.com/upm-cli/install.sh | bash
  

  Тип: Чтобы установить конкретную версию вместо последней версии, добавьте -s -- v#.#.# к команде install, заменяя v#.#.# в пределах фактического числа. Например, для установки v9.24.0, добавить -s -- v9.24.0.

• Windows (PowerShell):

  irm https://cdn.packages.unity.com/upm-cli/install.ps1 | iex
  

  Тип: Чтобы установить конкретную версию вместо последней версии, см. Установка с помощью нескольких команд.

Когда команда установки завершится, убедитесь, что вы перезапустили сессию терминала, чтобы изменения вступили в силу.

Установка с помощью нескольких команд

Чтобы установить или обновить до последней версии UPM CLI с возможностью проверки скрипта:

1. Откройте окно терминала (macOS или Linux) или окно PowerShell (Windows).

2. Загрузите скрипт установки для последней версии UPM CLI:

   • macOS или Linux:

     curl -fsSL https://cdn.packages.unity.com/upm-cli/install.sh -o install.sh
     

   • Windows (PowerShell):

     Invoke-WebRequest https://cdn.packages.unity.com/upm-cli/install.ps1 -OutFile install.ps1
     

3. (Необязательно) Проверьте скрипт установки перед его запуском:

   • macOS или Linux:

     less install.sh
     

     Введите q, чтобы вернуться к командной строке.

   • Windows (PowerShell):

     Get-Content install.ps1 | more
     

     Введите q, чтобы вернуться к команде PowerShell.

4. Запустить скрипт установки:

   • macOS или Linux:

     bash install.sh
     

   • Windows (PowerShell):

     . .\install.ps1
     

     Примечание: Если PowerShell блокирует скрипт из-за настроек политики выполнения, временно разрешите его с помощью следующих команд:

     Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
     .\install.ps1
     

   Тип: Чтобы установить конкретную версию вместо последней версии, добавьте v#.#.# к команде install, заменяя v#.#.# в пределах фактического числа. Например, для установки v9.24.0, добавить v9.24.0.

Когда скрипт установки завершится, убедитесь, что вы перезапустили сессию терминала, чтобы изменения вступили в силу.

Перезапустить сеанс терминала

Перезапустите Терминал или сессию PowerShell, чтобы изменения вступили в силу.

На macOS или Linux вы также можете запустить команду для конкретной оболочки в текущем сеансе:

• Zsh оболочка: source ~/.zshrc
• Оболочка Bash: source ~/.bashrc

Последующие шаги

После установки UPM CLI вы готовы упаковывать и подписывать пакет с UPM CLI.

Дополнительные ресурсы

• Unity Package Manager CLI рабочий процесс
• Упакуйте и подписайте пакет с Unity Package Manager CLI
• Введение в подписи пакетов
• Создать учетную запись сервиса