Пути к локальным папкам или архивам

Зависимость может быть указана как любая локальная папка или архив, содержащий пакет. Эта возможность полезна для локальной автономной разработки и тестирования.

Примечание: Если вы хотите сослаться на пакет в локальной файловой системе как на зависимость Git, используйте file://<url> формат вместо. Unity Git не поддерживает прямую ссылку на локально доступное хранилище Git с помощью пути к файлу. file://<url> формат, см. Зависимости Git.

В этом разделе описывается, как использовать манифест проекта для установки локальной зависимости. Если вы хотите использовать окно Package Manager вместо этого, следуйте инструкциям на этих страницах:

• Установка пакета из локальной папки
• Установка пакета из локального файла tarball

Ссылка на путь всегда начинается с префикса file: и использует прямые косые черты (/) для разделения путей.

Примечание: На Windows вы также можете использовать обратные косые скобки (\), но только если вы удаляете каждую из них (например, "file:..\\github\\my_package_folder" или "file:C:\\Users\\my_username\\github\\my_package_folder"). Эти пути не так легко читаются, как прямые косые скобки, они подвержены ошибкам, и вы можете использовать их только на машине Windows. По этим причинам использование прямых косых скобок предпочтительнее.

Вы можете использовать либо абсолютные пути, либо пути, относящиеся к папке Packages проекта (т.е. корневой папке манифеста проекта). Другими словами, путь, предшествующий двум точкам (..), относится к корню пути проекта, так что ../another_folder является родственником папки Packages.

Тип: Относительные пути с прямыми косыми линиями обеспечивают лучшую переносимость между различными машинами и операционными системами при отслеживании проекта и пакетов в одном и том же хранилище.

Для абсолютных путей Windows буква диска и его двоеточие (обычно C:) следуют за префиксом file:, но в остальном идентичны путям Linux или macOS.

Пример относительного пути

После префикса file: путь является стандартным относительным путем. В следующем примере:

• Папка проекта Packages — это C:\Users\my_username\Projects\my_project\Packages.
• Папки Projects, githubи Downloads являются папками участников.
• my_package_c является встроенным пакетом (пакет, папка которого была скопирована в папку Packages, чтобы сделать ее изменяемой).

{
  "dependencies": {
    "my_package_a": "file:../github/my_package_folder",
    "my_package_b": "file:../Downloads/my_package_tarball.tgz",
    "my_package_c": "file:com.unity.textmeshpro"
  }
}

Пример абсолютного пути в Linux или macOS

После префикса file: путь является стандартным путем Portable Operating System Interface (POSIX), начинающимся с косы /:

{
  "dependencies": {
    "my_package_a": "file:/Users/my_username/github/my_package_folder",
    "my_package_b": "file:/Users/my_username/Downloads/my_package_tarball.tgz"
  }
}

Пример абсолютного пути в Windows

Обратите внимание, что буква диска сразу же следует за префиксом file::

{
  "dependencies": {
    "my_package_a": "file:C:/Users/my_username/github/my_package_folder",
    "my_package_b": "file:C:/Users/my_username/Downloads/my_package_tarball.tgz"
  }
}