mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 02:10:21 +08:00
48 lines
2.2 KiB
Markdown
48 lines
2.2 KiB
Markdown
# Contributing to MaaAssistantArknights
|
|
|
|
1. If you have forked this repository before, please go to `Settings`, scroll down to the bottom, and click `Delete Repository`.
|
|
2. Go to [MAA main repository](https://github.com/MaaAssistantArknights/MaaAssistantArknights) and click `Fork`, then `Create fork`.
|
|
3. Clone the `dev` branch of the repository (of your account) to local:
|
|
|
|
```bash
|
|
git clone "your git repo link" -b dev
|
|
```
|
|
|
|
4. Configure development environment
|
|
|
|
1. Download and install `Visual Studio 2022 Community`. Select `Desktop development with C++` and `.NET Desktop Development`.
|
|
|
|
5. Double-click to open the file `MeoAssistantArknights.sln`. Visual Studio will load the project automatically.
|
|
6. Run a build to test whether the development environment has been configured correctly. Chosse `Release` & `x64`, right-click `MeoAsstGui` to set it as the startup project, and run it. If the build is successful, the `MeoAsstGui` window will appear. You can connect to the emulator in order to confirm again that the development environment has been configured correctly.
|
|
7. Now you are free to contribute to MAA.
|
|
8. Remember to commit once you have proper number of changes. Don't forget to write a commit message.
|
|
9. After development, push your local changes to the remote (of your repository).
|
|
|
|
```bash
|
|
git push origin dev
|
|
```
|
|
|
|
10. Go to [MAA repository](https://github.com/MaaAssistantArknights/MaaAssistantArknights) and submit a Pull Request. Wait until the administrator approves it. Please note that the changes should be based on `dev` instead of `master` branch, and should be merged to `dev` branch as well.
|
|
11. When there are changes from other contributors on original MAA repository, it is necessary for you to merge them to your forked repository.
|
|
1. Add MAA upstream repository.
|
|
|
|
```bash
|
|
git remote add upstream https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
|
|
```
|
|
|
|
2. Fetch upstream changes from the repository.
|
|
|
|
```bash
|
|
git fetch upstream
|
|
```
|
|
|
|
3. Merge changes.
|
|
|
|
```bash
|
|
git merge
|
|
```
|
|
|
|
4. Repeat step 7-10.
|
|
|
|
Note: operations regarding to Git can be done by VS2022 instead of command line tools, using the Git changes tab.
|