InVisionAR App
This is the repository with the Unity code for the main InVisionAR app.
Development Enviornment Requirements
- Git
- Git LFS
- Visual Studio Code
- Unity 2020.2.5f1
- This is highly subject to change, so please update your Unity installation as neccesary.
- Remember to install Android Build Support
- Remember to install iOS build support(only do this if you are on a Mac and have an iPhone)
- Android Studio
- XCode(only on Mac if you have an iPhone)
- A phone with AR support(either an Android with ARCore support or an iPhone). Not required, but will make your job much easier.
Setting up the devlopment environment
- Fork this repository
- Clone the fork you made using
git clone
under your account. (Make sure you have Git LFS installed)
cd
into the folder and keep the terminal open. Add the project to Unity(make sure the version is correct) and open the project.
- Set VSCode as the default editor for Unity(make sure VSCode is installed before you do this)
- Also open the project in VSCode(you can do this either by opening a script file from Unity or by opening VSCode seperately and opening the project folder)
- Open the VSCode terminal with
Ctrl + `
- Run
git remote add upstream https://github.com/InVisionAR/web-frontend.git
to set the root repository as the upstream remote.
- Create a new branch with
git branch new-branch-name
- If the new branch is for a new feature, prefix the branch name with
feature/
. For example, feature/login-system
- If the new branch name is a bug fix, prefix the branch name with
bugfix/
. For example, bugfix/signup-error
- Switch to the new branch with
git checkout new-branch-name
.
- Make a small change relavent to your task(like creating a new scene or a script file), add the changes with
git add .
, commit the changes with git commit -m "Intitial commit for <task-name>"
and push your changes with git push origin new-branch-name
- Create a pull request from your branch to the master branch of the main repository(not the master of your repository)
- Start working on your task!
- Stage and commit changes regularly with
git add .
and git commit -m "commit message"
, respectively.
- Push your changes regularly with
git push origin new-branch-name
- Pull changes from upstream master regulary with
git pull upstream master
. Run step 6 after pulling from upstream master. If there are merge conflicts, ask for help.
- When you are finished working on a task, ask for code review from Sagar Patil.
- Wait for code review.
- Fix things according to review feedback.
- If code review is passed, your branch will be merged. Go to step 6 and start working your next task. If your review did not pass, go back to step 15.