the-honkers-railway-launcher/README.md
2023-03-19 17:06:11 +02:00

130 lines
5.1 KiB
Markdown

<img src="repository/logo.jpg">
| Modern style | Classic style |
| :-: | :-: |
| <img src="repository/main-modern.png"> | <img src="repository/main-classic.png"> |
| <img src="repository/settings-modern.png"> | <img src="repository/settings-classic.png"> |
<p align="center">
<a href="https://discord.gg/ck37X6UWBp">Discord</a> ·
<a href="https://matrix.to/#/#an-anime-game:envs.net">Matrix</a> ·
<a href="https://github.com/an-anime-team/an-anime-game-launcher/wiki">Wiki</a>
</p>
<br>
# Please don't link to this repository
We understand you want to help people run An Anime Game on Linux. The issue is, the more people know
of the tools involved in it, the higher the chances The Anime Game Company will notice them, and then
fix the flaws that let us do the needful.
While sharing in your self-managed chat services and through private messaging is fine, we humbly ask
that you refrain from publically sharing links to this repository, or to any of the tools involved.
Or share them and ruin it for the dozens of Linux players. It's up to you.
## If you're going to share it anyway
Do what you must, but we would respectfully request that you try to label the game as "An Anime Game"
instead of the actual name of the game, to avoid search engine parsing.
# Documentation
Documentation for the launcher can be found in the [repository wiki](https://github.com/an-anime-team/an-anime-game-launcher/wiki).
# Download
| Source | Link |
| --- | --- |
| Native | [Releases](https://github.com/an-anime-team/an-anime-game-launcher/releases) page |
| AUR | [an-anime-game-launcher-bin](https://aur.archlinux.org/packages/an-anime-game-launcher-bin) |
| Pacstall | [an-anime-game-launcher-bin](https://pacstall.dev/packages/an-anime-game-launcher-bin) |
| Ebuild | [an-anime-game-launcher](https://github.com/an-anime-team/aagl-ebuilds) |
| RPM | [an-anime-game-launcher](https://build.opensuse.org/repositories/home:Maroxy:AAT-Apps/AAGL) |
| NixOS | [an-anime-game-launcher](https://github.com/ezKEa/aagl-gtk-on-nix) |
## Flatpak support
To install the launcher via flatpak you will first have to make sure that you have flathub's remote installed
```zsh
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
```
After installing flathub's remote you install launcher.moe's remote
NOTE: You can install the repo on a per user base by appending --user after --if-not-exists (This is especially useful if on Steam Deck)
```zsh
flatpak remote-add --if-not-exists launcher.moe https://gol.launcher.moe/gol.launcher.moe.flatpakrepo
```
Now the only thing remaining is to install the launcher
```zsh
flatpak install launcher.moe moe.launcher.an-anime-game-launcher
```
Some additional configuration is possible when using the flatpak. For info about this, see [this page](https://github.com/an-anime-team/an-anime-game-launcher/wiki/Additional-configuration)
## Chinese version support
This should be automatically enabled if you're using zh_cn (Chinese) as your system language. If you're not using it - you'll need to set `China` as your `launcher.edition` in the `config.json` file
# Development
| Folder | Description |
| - | - |
| anime-launcher-sdk | Unified core functionality for the launcher |
| src | Rust source code |
| assets | App assets folder |
| assets/locales | App localizations |
| target/release | Release build of the app |
## Clone repo
```sh
git clone --recursive https://github.com/an-anime-team/an-anime-game-launcher
```
## Run app
```sh
cargo run
```
## Build app
```sh
cargo build --release
```
## Updates strategy
Starting from 3.2.1 ([fcab428](https://github.com/an-anime-team/an-anime-game-launcher/commit/fcab428cb40b1457f41e0856f9d1e1473acbe653)) we have 2 branches: stable ([main](https://github.com/an-anime-team/an-anime-game-launcher/tree/main)) and dev ([next](https://github.com/an-anime-team/an-anime-game-launcher/tree/next)). Code changes will be pushed into dev branch and merged into stable once they're ready for new version release
```
main: next: pull request:
┌─────┐
│3.2.1├───────────┬─────────────────┐
└──┬──┘ │ │
│ │ │
│ ┌─────▼────┐ │ *checkout from both
│ │ fix: ... ├─ ── ── ── ─┤ branches accepted
│ └─────┬────┘ │
│ │ ┌────▼────┐
│ │ │feat: ...│
│ ┌─────▼────┐ └────┬────┘
│ │feat: ... │ │
│ └─────┬────┘ │
│ │ │
│ ┌─────▼────┐ │
│ │merge: ...◄────────────┘
│ └─────┬────┘
│ │
┌──▼──┐ │
│3.2.2◄───────────┘
└─────┘
```