{"id":19685760,"url":"https://github.com/mob-sakai/upmgitextension","last_synced_at":"2025-04-12T21:20:18.180Z","repository":{"id":38420454,"uuid":"164530906","full_name":"mob-sakai/UpmGitExtension","owner":"mob-sakai","description":"This package extends the UI of Unity Package Manager (UPM) for the packages installed from git repository.","archived":false,"fork":false,"pushed_at":"2023-11-21T02:55:36.000Z","size":711,"stargazers_count":785,"open_issues_count":8,"forks_count":80,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-04-04T00:11:27.763Z","etag":null,"topics":["bitbucket","editor","extension","git","github","package","package-manager","unity","unity3d","upm"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mob-sakai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"mob-sakai","patreon":"mob_sakai","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2019-01-08T01:43:24.000Z","updated_at":"2025-04-03T10:12:56.000Z","dependencies_parsed_at":"2022-07-14T10:48:35.250Z","dependency_job_id":"39ee74ae-06e5-4dfe-9d15-8569380a7e39","html_url":"https://github.com/mob-sakai/UpmGitExtension","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mob-sakai%2FUpmGitExtension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mob-sakai%2FUpmGitExtension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mob-sakai%2FUpmGitExtension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mob-sakai%2FUpmGitExtension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mob-sakai","download_url":"https://codeload.github.com/mob-sakai/UpmGitExtension/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248632251,"owners_count":21136653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitbucket","editor","extension","git","github","package","package-manager","unity","unity3d","upm"],"created_at":"2024-11-11T18:23:53.280Z","updated_at":"2025-04-12T21:20:18.149Z","avatar_url":"https://github.com/mob-sakai.png","language":"C#","funding_links":["https://github.com/sponsors/mob-sakai","https://patreon.com/mob_sakai","https://www.patreon.com/posts/25070968","https://www.patreon.com/join/2343451?"],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://git-scm.com/images/logos/downloads/Git-Icon-1788C.svg\" height=\"24px\" \u003e UPM Git Extension\n\nThis package enhances the user interface (UI) of the Unity Package Manager (UPM) specifically for packages installed\nfrom a git repository.\n\n![](https://user-images.githubusercontent.com/12690315/60764681-20c28380-a0c9-11e9-9c3c-75e3d4e0279e.png)\n\n[![](https://img.shields.io/npm/v/com.coffee.upm-git-extension?label=openupm\u0026registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.coffee.upm-git-extension/)\n[![](https://img.shields.io/github/v/release/mob-sakai/UpmGitExtension?include_prereleases)](https://github.com/mob-sakai/UpmGitExtension/releases)\n[![](https://img.shields.io/github/license/mob-sakai/UpmGitExtension.svg)](https://github.com/mob-sakai/UpmGitExtension/blob/main/LICENSE.txt)  \n![](https://img.shields.io/badge/Unity-2018.3+-57b9d3.svg?style=flat\u0026logo=unity)\n![](https://github.com/mob-sakai/UpmGitExtension/actions/workflows/test.yml/badge.svg?branch=develop)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-orange.svg)](http://makeapullrequest.com)\n[![](https://img.shields.io/twitter/follow/mob_sakai.svg?label=Follow\u0026style=social)](https://twitter.com/intent/follow?screen_name=mob_sakai)\n\n\u003c\u003c [📝 Description](#-description) | [⚙ Installation](#-installation) | [🚀 Usage](#-usage) | [🛠 Development Note](#-development-note) | [🤝 Contributing](#-contributing) \u003e\u003e\n\n## 📝 Description\n\nIn Unity 2018.3, the Unity Package Manager (UPM) introduced Git support, providing a convenient way to install packages\nfrom code hosting services such as GitHub. However, certain limitations and shortcomings were identified, including:\n\n- Incorrect links to documents (readme, changelog, license)\n- Lack of a direct link to the repository URL\n- Limited functionality for adding, updating, and removing packages through the UI\n\nThis project addresses these issues by extending the UI of the Unity Package Manager for packages installed using Git.\n\n### Features\n\n- Direct link to the Git repository URL\n- Links to offline documents, including:\n    - Documentations\n    - Changelog\n    - License\n- Support for various Git hosting platforms such as GitHub, GitLab, Bitbucket, Azure DevOps, etc.\n- Installation of packages from Git repository URLs using the UI\n- Updating packages with a specific tag/branch\n- Removing packages\n- Compatibility with Unity 2018.3 or later\n- Support for `.Net 3.5`, `.Net 4.x`, and `.Net Standard 2.0`\n- Version filtering\n- Support for path query parameters (for Unity 2019.3.4f or later)\n- (Version 2.0.0) Git repositories are cached, and installed/searched packages are automatically indexed:\n    - Cached repositories are shared between different projects\n    - Cached repository URLs are displayed as history in the installation window\n    - Indexed packages are shown in `My Registries`\n- (Version 2.0.0) Additional menu options to open `manifest.json` with a code editor, open the cache directory, clear\n  the cache, and fetch packages:\n  ![](https://user-images.githubusercontent.com/12690315/169232173-943ee8cf-9d18-435d-aea2-3fdd16538cf7.png)\n\n\u003cbr\u003e\u003cbr\u003e\n\n## ⚙ Installation\n\nThis package requires as following:\n\n- **v1.x**: Unity 2018.3 to 2019.4\n- **v2.x**: Unity 2020.1 or later\n\n#### Install via OpenUPM\n\nThis package is available on [OpenUPM](https://openupm.com) package registry.\nThis is the preferred method of installation, as you can easily receive updates as they're released.\n\nIf you have [openupm-cli](https://github.com/openupm/openupm-cli) installed, then run the following command in your\nproject's directory:\n\n```sh\n# for Unity 2020 or later\nopenupm add com.coffee.upm-git-extension\n# for Unity 2018 or 2019\nopenupm add com.coffee.upm-git-extension@v1 \n```\n\n#### Install via UPM (using Git URL)\n\nNavigate to your project's Packages folder and open the `manifest.json` file. Then add this package somewhere in\nthe `dependencies` block:\n\n```json\n{\n  \"dependencies\": {\n    // for Unity 2020 or later\n    \"com.coffee.upm-git-extension\": \"https://github.com/mob-sakai/UpmGitExtension.git\",\n    // for Unity 2018 or 2019\n    \"com.coffee.upm-git-extension\": \"https://github.com/mob-sakai/UpmGitExtension.git#v1\",\n    ...\n  },\n}\n```\n\nTo update the package, change suffix `#{version}` to the target version.\n\n* e.g. `\"com.coffee.upm-git-extension\": \"https://github.com/mob-sakai/UpmGitExtension.git#2.1.0\",`\n\n\u003cbr\u003e\u003cbr\u003e\n\n## 🚀 Usage\n\n### Install a Package from a Git Repository\n\n1.\nClick ![giticon](https://user-images.githubusercontent.com/12690315/60764763-7fd4c800-a0ca-11e9-957b-ca68e3ca6123.png)\nbutton in the package manager UI to open the `Install Package Window`.  \n![](https://user-images.githubusercontent.com/12690315/60766233-dbf71680-a0e1-11e9-8303-fbd790e9e35b.png)  \n![](https://user-images.githubusercontent.com/12690315/60764768-91b66b00-a0ca-11e9-9ccd-9fef88c77d5e.png)\n\n2. Input a git repository URL and click the `Find Versions` button. In Unity 2019.3.4 or later, you can specify a\n   subdirectory.  \n   ![](https://user-images.githubusercontent.com/12690315/60766258-4314cb00-a0e2-11e9-91f8-3aad514450bc.png)\n\n3. Select a tag or branch and click the `Find Package` button.  \n   ![](https://user-images.githubusercontent.com/12690315/60766257-4314cb00-a0e2-11e9-8b2e-23efc50ded72.png)\n\n4. Wait a few seconds for validation.\n\n5. Click the `Install Package` button to install the package.  \n   ![](https://user-images.githubusercontent.com/12690315/60766259-4314cb00-a0e2-11e9-9b89-0bc0d4f71517.png)\n\n### Update Package with a Specific Tag or Branch as Version\n\nYou can update or remove the package in your project, _just as you would for official packages._\n\n\u003cbr\u003e\u003cbr\u003e\n\n## 🛠 Development Note\n\n### Develop a package for UPM\n\nSee https://www.patreon.com/posts/25070968, https://www.jianshu.com/u/275cca6e5f17 (Chinese)\n\n\u003cbr\u003e\u003cbr\u003e\n\n## 🤝 Contributing\n\n### Issues\n\nIssues are incredibly valuable to this project:\n\n- Ideas provide a valuable source of contributions that others can make.\n- Problems help identify areas where this project needs improvement.\n- Questions indicate where contributors can enhance the user experience.\n\n### Pull Requests\n\nPull requests offer a fantastic way to contribute your ideas to this repository.  \nPlease refer to [CONTRIBUTING.md](https://github.com/mob-sakai/UpmGitExtension/tree/develop/CONTRIBUTING.md) and [develop branch](https://github.com/mob-sakai/UpmGitExtension/tree/develop) for guidelines.\n\n### Support\n\nThis is an open-source project developed during my spare time.  \nIf you appreciate it, consider supporting me.  \nYour support allows me to dedicate more time to development. 😊\n\n[![](https://user-images.githubusercontent.com/12690315/50731629-3b18b480-11ad-11e9-8fad-4b13f27969c1.png)](https://www.patreon.com/join/2343451?)  \n[![](https://user-images.githubusercontent.com/12690315/66942881-03686280-f085-11e9-9586-fc0b6011029f.png)](https://github.com/users/mob-sakai/sponsorship)\n\n\u003cbr\u003e\u003cbr\u003e\n\n## License\n\n* MIT\n\n## Author\n\n* ![](https://user-images.githubusercontent.com/12690315/96986908-434a0b80-155d-11eb-8275-85138ab90afa.png) [mob-sakai](https://github.com/mob-sakai) [![](https://img.shields.io/twitter/follow/mob_sakai.svg?label=Follow\u0026style=social)](https://twitter.com/intent/follow?screen_name=mob_sakai) ![GitHub followers](https://img.shields.io/github/followers/mob-sakai?style=social)\n\n## See Also\n\n- GitHub page : https://github.com/mob-sakai/UpmGitExtension\n- Releases : https://github.com/mob-sakai/UpmGitExtension/releases\n- Issue tracker : https://github.com/mob-sakai/UpmGitExtension/issues\n- Current project : https://github.com/mob-sakai/UpmGitExtension/projects/1\n- Change log : https://github.com/mob-sakai/UpmGitExtension/blob/main/CHANGELOG.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmob-sakai%2Fupmgitextension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmob-sakai%2Fupmgitextension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmob-sakai%2Fupmgitextension/lists"}