Compare commits
1 Commits
feat/3-cic
...
4b24be1886
| Author | SHA1 | Date | |
|---|---|---|---|
| 4b24be1886 |
BIN
Docs/Img/sandbox-add-picture.png
LFS
Normal file
BIN
Docs/Img/sandbox-add-picture.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/visual-studio-gcm.png
LFS
Normal file
BIN
Docs/Img/visual-studio-gcm.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/visual-studio-git-option.png
LFS
Normal file
BIN
Docs/Img/visual-studio-git-option.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/visual-studio-git-options-window.png
LFS
Normal file
BIN
Docs/Img/visual-studio-git-options-window.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/visual-studio-git-window.png
LFS
Normal file
BIN
Docs/Img/visual-studio-git-window.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/visual-studio-project-selector.png
LFS
Normal file
BIN
Docs/Img/visual-studio-project-selector.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/visual-studio-remote-repo.png
LFS
Normal file
BIN
Docs/Img/visual-studio-remote-repo.png
LFS
Normal file
Binary file not shown.
BIN
Docs/Img/windows-vs-feature-selection.png
LFS
Normal file
BIN
Docs/Img/windows-vs-feature-selection.png
LFS
Normal file
Binary file not shown.
143
readme.md
Normal file
143
readme.md
Normal file
@@ -0,0 +1,143 @@
|
|||||||
|
# Project Titan
|
||||||
|
|
||||||
|
Index:
|
||||||
|
|
||||||
|
- [Getting Started](#getting-started)
|
||||||
|
- [Visual Studio Configuration](#configuring-visual-studio)
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
Working on this project requires some things you need to install. Those being
|
||||||
|
Visual Studio, S&box, Git (LFS enabled). Among that you will need access to the
|
||||||
|
[Gitea](https://gitea.vps.collinssoft.com). You'll know who to reach out to
|
||||||
|
if you are lacking access. This will only target Windows development since
|
||||||
|
S&box only supports Windows, however, in the future they do plan to support
|
||||||
|
Linux.
|
||||||
|
|
||||||
|
#### 1.) Installing Git and Git LFS
|
||||||
|
|
||||||
|
This is realively simple to do, just go to [git's website](https://git-scm.com/)
|
||||||
|
and download the installer for Windows. All the default settings are acceptable,
|
||||||
|
but if you want to take a look at what they are and pick and choose feel free ;).
|
||||||
|
|
||||||
|
In order to enable Git LFS you will have to open the terminal and run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git lfs install
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2.) Install S&Box
|
||||||
|
|
||||||
|
Right now S&Box is only available through building it ourselves and Steam. This will
|
||||||
|
go over how to gain access through Steam. To get access you will have to go through
|
||||||
|
[this url](https://sbox.game/give-me-that). Once you have completed that, you will
|
||||||
|
have it in your Steam library.
|
||||||
|
|
||||||
|
*NOTE: depending on how you chose to install S&Box will affect whether the S&Box
|
||||||
|
editor will work for you through Steam. If you try and it doesn't work, you can
|
||||||
|
access the locally installed files and `sbox-dev.exe` can be used.*
|
||||||
|
|
||||||
|
When it releases in Steam on April 28th, 2026 the project will provide the funds
|
||||||
|
for all developers to gain access, and this documentation will be updated.
|
||||||
|
|
||||||
|
#### 3.) Install Visual Studio
|
||||||
|
|
||||||
|
Installing Visual Studio is similar process to installing Git but with some UI
|
||||||
|
elements added. To start download the installer from [Microslop](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=learn.microsoft.com&utm_campaign=inline+link&0utm_content=download+vs2026+desktopguide+winforms).
|
||||||
|
|
||||||
|
Once you run the installer, you should something similar to this:
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
*NOTE: Do not feel the need to login or create an account, you can skip it*
|
||||||
|
|
||||||
|
The only thing that needs to be selected is the `.NET Multiplatform App UI development`.
|
||||||
|
Feel free to choose what optional things you want in addition, as you can notice the picture
|
||||||
|
depicts the Copilot options being disabled. This install will take a few minutes, but once
|
||||||
|
complete you now have an IDE to do development with.
|
||||||
|
|
||||||
|
#### 4.) Clone the Project
|
||||||
|
|
||||||
|
Cloning is the process of creating a replica of the Git repository on your local file system.
|
||||||
|
To do this we will be using the terminal, however, you can setup Visual Studio to do the
|
||||||
|
same thing. If you would rather go down that route, there are plenty of tutorials on the subject
|
||||||
|
so feel free.
|
||||||
|
|
||||||
|
Open a terminal and traverse to the directory that you wish the project to be cloned to. Once you
|
||||||
|
are there you can run the command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://gitea.vps.collinssoft.com/Relic/Titan.git
|
||||||
|
```
|
||||||
|
|
||||||
|
This will create a titan folder and download all the contents of the repository to that folder.
|
||||||
|
|
||||||
|
#### 5.) Add the Project to S&Box
|
||||||
|
|
||||||
|
Opening up S&Box you should see the project selector pop up.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
In the picutre you can see an arrow pointing to a button, clicking
|
||||||
|
that button will open up the explorer. Traverse to the project root
|
||||||
|
and click Open. After that you should have the project appear as a
|
||||||
|
selectable option. Click that and it will open the S&Box editor and
|
||||||
|
now you can start working on the project.
|
||||||
|
|
||||||
|
*NOTE: Make sure that you have started the project with S&Box it will
|
||||||
|
generate a slnx file that will be needed for Visual Studio in the next
|
||||||
|
step.*
|
||||||
|
|
||||||
|
#### 6.) Add the Project to Visual Studio
|
||||||
|
|
||||||
|
The last step is to configure Visual Studio, and much like the last step
|
||||||
|
is to configure Visual Studio to the path of the project.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Click on `Open a project or solution` will open the explorer window. Traversing
|
||||||
|
to the root of the project that was cloned and click the slnx file and it will
|
||||||
|
open the project. Next time you open Visual Studio it will be a selectable option.
|
||||||
|
|
||||||
|
## Configuring Visual Studio
|
||||||
|
|
||||||
|
Index:
|
||||||
|
|
||||||
|
- [Git](#visual-studio-git)
|
||||||
|
|
||||||
|
### Visual Studio Git
|
||||||
|
|
||||||
|
We will be using Git for working together on this project, and Visual Studio being
|
||||||
|
a fully fledge IDE has support for that workflow.
|
||||||
|
|
||||||
|
Up in the top left corner there is a Git tab, contained in that tab you should see
|
||||||
|
something similar to this ->
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
As you can see we already have the local repository, the only other thing we need
|
||||||
|
to do is setup the remote.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Once that is clicked you should see another window pop up.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
All that you need to confiure is the `User name` and the `Email` fields, these
|
||||||
|
should be the same as your Gitea user is configured with.
|
||||||
|
|
||||||
|
Lastly you need to configure your authentication, in the same window you were just in
|
||||||
|
click on `Git Global Config` and you should see this window.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Validate that the setting `Credential Helper` is set to GCM.
|
||||||
|
|
||||||
|
## Using Visual Studio to Push Code to Gitea
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
Click the `Git Changes` tab in the bottom left will open the tab to a different window
|
||||||
|
where you can push your code. Contained in this Git window shows what branch you are
|
||||||
|
on, the changes that are present, a place to put commit messages and much more.
|
||||||
Reference in New Issue
Block a user