You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jul 12, 2018. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+100-2
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,104 @@ Welcome to the GitHub for Unity preview!
4
4
5
5
The GitHub for Unity plugin brings Git and GitHub into Unity, integrating source control into your work with friendly and accessible tools and workflows.
6
6
7
-
We will be releasing the first alpha of GitHub for Unity very soon. Watch this repository and get notified when we release!
7
+
This software is currently on [Early Access](https://developer.github.com/early-access/) and is alpha-quality. Please check the release notes for bugs and known issues, and make sure you have backups of your work. Use with care.
For any questions or bug reports, you can [open an issue](https://github.com/github-beta/unity-preview/issues/new) in our issue tracker, or send email to [[email protected]](mailto:[email protected]).
To install the extension, [download the package](https://github.com/github-beta/unity-preview/releases/tag/v0.8-alpha) from [the releases page](https://github.com/github/UnityInternal/releases) and double click on it.
17
+
18
+
## Opening the GitHub window
19
+
20
+
You can access the GitHub window by going to Windows -> GitHub. The window opens by default next to the Inspector window.
If the current Unity project is not in a git repository, the GitHub for Unity extension will offer to initialize the repository for you. This will:
27
+
28
+
- Initialize a git repository at the Unity project root via `git init`
29
+
- Initialize git-lfs via `git lfs install`
30
+
- Set up a `.gitignore` file at the Unity project root.
31
+
- Set up a `.gitattributes` file at the Unity project root with a large list of known binary filetypes (images, audio, etc) that should be tracked by LFS
32
+
- Configure the project to serialize meta files as text
33
+
- Create an initial commit with the `.gitignore` and `.gitattributes` file.
34
+
35
+
### Authentication
36
+
37
+
To set up credentials in git so you can push and pull, you can sign in to GitHub by going to `Window` -> `GitHub` -> `Account` -> `Sign in`. You only have to sign in successfully once, your credentials will remain on the system for all git operations in Unity and outside of it. If you've already signed in once but the Account dropdown still says `Sign in`, ignore it, it's a bug.
1. Go to [github.com](https://github.com) and create a new empty repository - do not add a license, readme or other files during the creation process
44
+
2. Copy the **https** url shown in the creation page
45
+
3. In Unity, go to `Windows` -> `GitHub` -> `Settings` and paste the url into the `Remote` textbox.
46
+
3. Click `Save repository`.
47
+
4. Go to the `History` tab and click `Push`
48
+
49
+
### Commiting your work - Changes tab
50
+
51
+
You can see which files have been changed and commit them through the Changes tab. `.meta` files will show up in relation to their files on the tree, so you can select a file for comitting and automatically have their `.meta`
The history tab includes a `Push` button to push your work to the server. Make sure you have a remote url configured in the `Settings` tab so that you can push and pull your work.
58
+
59
+
To receive updates from the server by clicking on the `Pull` button. You cannot pull if you have local changes, so commit your changes before pulling.
The GitHub for Unity extension ships with a bundle of git and git-lfs, to ensure that you have the correct version. These will be installed into `%LOCALAPPDATA%\GitHubUnityDebug` when the extension runs for the first time.
78
+
79
+
You can open a command line with the same git and git-lfs version that the extension uses by going to the GitHub -> Command line menu.
80
+
81
+
Make sure a git user and email address are set in the `%HOME%\.gitconfig` file before you initialize a repository for the first time. You can set these values by opening your `%HOME%\.gitconfig` file and adding the following section, if it doesn't exist yet:
82
+
83
+
```
84
+
[user]
85
+
name = Your Name
86
+
email = Your Email
87
+
```
88
+
89
+
### Log files
90
+
91
+
The extension log file can be found at `%LOCALAPPDATA%\GitHubUnityDebug\github-unity.log`
92
+
93
+
## macOS
94
+
95
+
The current release has limited macOS support. macOS users will need to install the latest [git](https://git-scm.com/downloads) and [git-lfs](https://git-lfs.github.com/) manually, and make sure these are on the path. You can configure the git location in the Settings tab on the GitHub window.
96
+
97
+
Make sure a git user and email address are set in the `~/.gitconfig` file before you initialize a repository for the first time. You can set these values by opening your `~/.gitconfig` file and adding the following section, if it doesn't exist yet:
98
+
99
+
```
100
+
[user]
101
+
name = Your Name
102
+
email = Your Email
103
+
```
104
+
105
+
### Log files
106
+
107
+
The extension log file can be found at `~/.local/share/GitHubUnityDebug/github-unity.log`. This is a temporary location and will be changed in the future.
0 commit comments