MHWD - RebornOS

MHWD for RebornOS.

Note: This project should not carry any RebornOS-specific configuration except for the application packaging files (PKGBUILD, build scripts), icons, and launch scripts. Use the mhwd-db-rebornos project for other RebornOS-specific configuration.

This is a fork of the MHWD CachyOS project. It is highly recommended to keep this project updated.

Cloning

In order to download the source code to your local computer for testing, or for development, you can clone from the remote repository using either SSH, or HTTPS. Below are instructions on how to do so using Gitlab hosted code as remote.

HTTPS

git clone https://github.com/RebornOS-Developers/mhwd-rebornos.git 

OR

SSH

git clone [email protected]:RebornOS-Developers/mhwd-rebornos.git

Local development

1. Build

The below script will build the ISO image (and install any prerequisites). Change to the project directory (cd mhwd-rebornos) and run th below. You can specify any commandline parameters to makepkg by passing it to the below script

sh scripts/build.sh

2. Run

Change to the project directory (cd mhwd-rebornos) and run the below. You can specify any commandline parameters to mhwd-rebornos by passing it to the below script

sh scripts/run.sh

Packaging

Change to the project directory (cd mhwd-rebornos) and run any of the below scripts:

• sh packaging/setup.sh <MODE>: Builds and installs a package

• sh packaging/build-package.sh <MODE>: Just builds a package without installing it locally

• sh packaging/install-package.sh <MODE>: Just installs a package locally, except if no built package is detected, a package is built.

• where <MODE> can be one of the below

  1. local: Selects mhwd-rebornos-local from the local project that you have cloned already.
  2. git: Selects mhwd-rebornos-git from the latest git commit.
  3. stable: Selects mhwd-rebornos from the git tag corresponding to the pkgver specified in the PKGBUILD. If pkgver=0.0.1, then the git tag v0.0.1 is used for packaging.

Note: Any additional parameters passed to the above scripts are automatically sent to makepkg or pacman (whichever is applicable).

Updating

To keep this project in sync with the upstream mhwd-cachyos source, please follow the below steps. Change to the project directory (cd mhwd-rebornos) before continuing...

1. Fetch changes from the upstream Github source: The below script clones the upstream mhwd-cachyos source to the mhwd branch (force overwrites it).

sh scripts/update_mhwd_branch.sh

2. Merge upstream changes

git checkout main

git merge mhwd

3. Manually handle merge conflicts: Follow this guide for commandline operations or this guide if you are using Visual Studio Code.

4. Push updates back to the project: After all the merge conflicts are handled and you stage all the changes, you are ready to push the updates with git push.