forked from clash-verge-rev/clash-verge-rev
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: Add guidelines for windows development (clash-verge-rev#250)
- Loading branch information
Showing
2 changed files
with
70 additions
and
23 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,67 @@ | ||
# CONTRIBUTING | ||
|
||
Thank you for your interest in contributing to Clash Verge Rev! This document provides guidelines and instructions to help you set up your development environment and start contributing. | ||
|
||
## Development Setup | ||
|
||
Before you start contributing to the project, you need to set up your development environment. Here are the steps you need to follow: | ||
|
||
### Prerequisites | ||
|
||
1. **Install Rust and Node.js**: Our project requires both Rust and Node.js. Please follow the instructions provided [here](https://tauri.app/v1/guides/getting-started/prerequisites) to install them on your system. | ||
|
||
### Setup for Windows Users | ||
|
||
If you're a Windows user, you may need to perform some additional steps: | ||
|
||
- Make sure to add Rust and Node.js to your system's PATH. This is usually done during the installation process, but you can verify and manually add them if necessary. | ||
- The gnu `patch` tool should be installed | ||
|
||
### Install Node.js Packages | ||
|
||
After installing Rust and Node.js, install the necessary Node.js packages: | ||
|
||
```shell | ||
pnpm i | ||
``` | ||
|
||
### Download the Clash Binary | ||
|
||
You have two options for downloading the clash binary: | ||
|
||
- Automatically download it via the provided script: | ||
```shell | ||
pnpm run check | ||
# Use '--force' to force update to the latest version | ||
# pnpm run check --force | ||
``` | ||
- Manually download it from the [Clash Meta release](https://github.com/MetaCubeX/Clash.Meta/releases). After downloading, rename the binary according to the [Tauri configuration](https://tauri.app/v1/api/config#bundleconfig.externalbin). | ||
|
||
### Run the Development Server | ||
|
||
To run the development server, use the following command: | ||
|
||
```shell | ||
pnpm dev | ||
# If an app instance already exists, use a different command | ||
pnpm dev:diff | ||
``` | ||
|
||
### Build the Project | ||
|
||
If you want to build the project, use: | ||
|
||
```shell | ||
pnpm build | ||
``` | ||
|
||
## Contributing Your Changes | ||
|
||
Once you have made your changes: | ||
|
||
1. Fork the repository. | ||
2. Create a new branch for your feature or bug fix. | ||
3. Commit your changes with clear and concise commit messages. | ||
4. Push your branch to your fork and submit a pull request to our repository. | ||
|
||
We appreciate your contributions and look forward to your active participation in our project! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters