Install a UPM package from a Git URL
Load a UPM package from a Git repository on a remote server.
읽는 시간 2분최근 업데이트: 9일 전
The Package Manager can load a UPM package from a Git repository on a remote server.
참고
If the package is in a private repository, you must configure your environment before continuing. Refer to Prerequisites for HTTPS and SSH setup.
Prerequisites
-
Install the Git client (minimum version 2.14.0) on your computer.
-
On Windows, add the Git executable path to thesystem environment variable.
PATH -
If the target repository tracks files with Git LFS, install the Git LFS client on your computer.
-
If the UPM package is in a private repository:
- For HTTPS Git URLs, configure your environment for private repositories. Refer to Use private repositories with HTTPS Git URLs.
- For SSH Git URLs, configure your SSH keys and access. Refer to Use passphrase-protected SSH keys with SSH Git URLs.
-
Read the information about using Git dependencies in your project.
Procedure
To install a UPM package from a Git URL:
-
Open the Package Manager window, if it's not already open.
-
Open the Add (+) menu in the Package Manager's toolbar.
-
The options for installing packages appear.
Install package from git URL button
-
Select Install package from git URL from the install menu. A text box and an Install button appear.
-
Enter a valid Git URL in the text box. Note: If the Git repository uses Git LFS, the imported package might contain pointer files instead of the actual content. Refer to Git LFS errors. For information about how to construct a valid Git URL, refer to Git URLs and extended syntax. Examples of valid Git URLs include:
- (if your package is in the root of the repository).
https://github.example.com/myuser/myrepo.git - (if your package is in a subfolder within the repository).
https://github.example.com/myuser/myrepo.git?path=/subfolder
-
Select Install.
If Unity was able to install the package successfully, the package now appears in the package list with the git label. If Unity wasn't able to install the package, the Unity Console displays an error message, such as:
- No 'Git' executable was found
- Git-lfs: command not found
- Repository not found
- Couldn't read Username: terminal prompts disabled
Click an error message link to get some help for it on the Package Manager troubleshooting page.
팁
If you want to check for updates and update your Git dependency to the latest version from the repository, click Update. You can also use the Install package from git URL menu item to update your Git dependency. For information on Git dependencies, refer to Locked Git dependencies.