Skip to content

Commit 40d4616

Browse files
authored
Update README.md
1 parent ee8befd commit 40d4616

File tree

1 file changed

+90
-2
lines changed

1 file changed

+90
-2
lines changed

README.md

Lines changed: 90 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,90 @@
1-
# Unity-CustomBuildUpdater
2-
1+
# Unity Custom Build Updater
2+
3+
Unity Custom Build Updater is a Unity package designed to streamline the build process for your Unity projects. It automates versioning, archiving, and build path management, making it easier to manage and distribute builds. This package is particularly useful for WebGL builds.
4+
5+
## Features
6+
7+
- Automatic version incrementing based on build type (Major, Feature, Bugfix, Build)
8+
- Customizable build paths with default and custom options
9+
- Automatic archiving of builds into zip files
10+
- Simple initialization and configuration through a Unity Editor window
11+
12+
## Installation
13+
14+
To install the Unity Custom Build Updater package, follow these steps:
15+
16+
1. Open your Unity project.
17+
2. Go to `Window > Package Manager`.
18+
3. Click on the `+` button in the top left corner.
19+
4. Select `Add package from git URL...`.
20+
5. Paste the following URL: `https://github.com/RimuruDev/Unity-CustomBuildUpdater.git`
21+
6. Click `Add`.
22+
23+
## Initialization
24+
25+
After installing the package, you need to initialize the build configuration. Follow these steps:
26+
27+
1. Go to `RimuruDev Tools > Initialize BuildConfig` in the top menu.
28+
2. This will create a `BuildConfig` asset in `Assets/Resources/Editor/BuildConfig.asset`.
29+
30+
## Configuration
31+
32+
### BuildConfig
33+
34+
The `BuildConfig` asset contains the following settings:
35+
36+
- **Company Name**: The name of your company.
37+
- **Product Name**: The name of your product.
38+
- **Initial Version**: The starting version of your build (e.g., `1.0.0.0`).
39+
- **Build Path Type**: The type of build path (`Default` or `Custom`).
40+
- **Custom Build Path**: The custom build path if `Build Path Type` is set to `Custom`.
41+
- **Archive Build**: Whether to archive the build into a zip file.
42+
- **Version Type**: The type of version increment (`Major`, `Feature`, `Bugfix`, `Build`).
43+
- **Version Pattern**: The pattern for the version naming (e.g., `com.{company}.{product}.v{version}`).
44+
45+
### Example
46+
47+
```csharp
48+
using UnityEngine;
49+
50+
namespace RimuruDev.Unity_CustomBuildUpdater.CustomBuildUpdater.Editor
51+
{
52+
[CreateAssetMenu(fileName = "BuildConfig", menuName = "Configs/Build/BuildConfig", order = 1)]
53+
public class BuildConfig : ScriptableObject
54+
{
55+
public string companyName = "AbyssMoth";
56+
public string productName = "SuperGame";
57+
public string initialVersion = "1.0.0.0";
58+
public BuildPathType buildPathType = BuildPathType.Default;
59+
public string customBuildPath = "Builds";
60+
public bool archiveBuild = true;
61+
public VersionType versionType = VersionType.Build;
62+
public string versionPattern = "com.{company}.{product}.v{version}";
63+
}
64+
}
65+
```
66+
67+
## Usage
68+
69+
### Updating the Version
70+
71+
To update the current version in the configuration:
72+
73+
1. Open the `BuildConfig` asset.
74+
2. Click on the `Update Current Version` button.
75+
76+
### Building the Project
77+
78+
To build the project using the configured settings:
79+
80+
1. Go to `File > Build Settings`.
81+
2. Configure your build settings as needed (make sure to select WebGL if testing WebGL builds).
82+
3. Click on `Build` and select the folder for your build.
83+
84+
## Contributing
85+
86+
Contributions are welcome! Please feel free to submit a Pull Request.
87+
88+
## License
89+
90+
This project is licensed under the MIT License.

0 commit comments

Comments
 (0)