Awesome
羽衣 - Hagoromo -
(English follows Japanese.)
概要
マルチカラム対応のBlueskyクライアントです。
動作確認環境
- Windows 11 Profesional
- Ubuntu 22.04
- Mac 15.0.1(x86 on ARM)
使用ソフトウェア
ダウンロード
ビルド済みの実行ファイルはReleasesよりダウンロードしてください。
インストール
アーカイブを解凍して任意のフォルダに保存してください。
使用方法
ユーザーマニュアルを参照してください。
ビルド方法
共通
ビルドするプラットフォームのQt 5.15.2をインストールしてください。
Official site : Qt
Windows
Microsoft Visual Studio 2022をインストールしてください(Community Edition可)。
改行コードをCRLFでチェックアウトしてください。
REM checkout repo
>git clone git@github.com:ioriayane/Hagoromo.git
>cd Hagoromo
>git submodule update -i
REM copy and edit encryption seed
>copy lib\tools\encryption_seed_template.h lib\tools\encryption_seed.h
REM build Hagoromo
>.\scripts\build.bat path\to\Qt\6.8.1\msvc2022_64\bin
REM Execute
>deploy-hagoromo\hagoromo\Hagoromo.exe
Ubuntu
build.shでビルドします。
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# setup dependent modules
$ sudo apt-get install zlib1g-dev
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh linux path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ ./deploy-hagoromo/hagoromo/Hagoromo.sh
Mac
build.shでビルドします。
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh mac path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ open ./deploy-hagoromo/hagoromo/Hagoromo.app
コントリビューション
変更を加えるときはdev
からブランチして、dev
にプルリクエストを提出してください。
また、下記の事項を実施してください。Github Actionsにてチェックしています。
ソースコードの整形
pre-commitを使用しています。
git hookで実行されるように公式サイトを確認してセットアップしてください。
セットアップ例
$ pip install pre-commit
$ pre-commit --version
pre-commit 3.7.1
$ cd path/to/this_repo
$ pre-commit install
pre-commit installed at .git/hooks/pre-commit
単体テスト
いづれかの環境で実行してクリアできることを確認してください。
Windows
> .\scripts\unittest.bat path\to\Qt\6.8.1\msvc2022_64\bin
Ubuntu
$ ./scripts/unittest.sh linux path/to/Qt/6.8.1/gcc_64/bin
Mac
$ ./scripts/unittest.sh mac path/to/Qt/6.8.1/gcc_64/bin
Overview
This is a multi-column Bluesky client.
System Requirements
- Windows 11 Profesional
- Ubuntu 22.04
- Mac 15.0.1(x86 on ARM)
Software used
Download
Please download the pre-built executable from Releases.
Installation
Unzip the archive and save it in any folder.
How to Use
Please refer to the User's Manual.
How to Build
Common
Install Qt 6.8.1 for the platform you want to build.
Official site : Qt
Windows
Install Microsoft Visual Studio 2022 (Community Edition is also available).
Check out the newline code in CRLF.
REM checkout repo
>git clone git@github.com:ioriayane/Hagoromo.git
>cd Hangoromo
>git submodule update -i
REM copy and edit encryption seed
>copy lib\tools\encryption_seed_template.h lib\tools\encryption_seed.h
REM build Hagoromo
>.\scripts\build.bat path\to\Qt\6.8.1\msvc2022_64\bin
REM Execute
>deploy-hagoromo\hagoromo\Hagoromo.exe
Ubuntu
It is built in build.sh.
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# setup dependent modules
$ sudo apt-get install zlib1g-dev
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh linux path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ ./deploy-hagoromo/hagoromo/Hagoromo.sh
Mac
It is built in build.sh.
# checkout repo
$ git clone git@github.com:ioriayane/Hagoromo.git
$ cd Hagoromo
$ git submodule update -i
# copy and edit encryption seed
$ cp lib/tools/encryption_seed_template.h lib/tools/encryption_seed.h
$ vi lib/tools/encryption_seed.h
# build Hagoromo
$ ./scripts/build.sh mac path/to/Qt/6.8.1/gcc_64/bin
# exec hagoromo
$ open ./deploy-hagoromo/hagoromo/Hagoromo.app
Contribution
If you want to make changes, please branch from dev
and submit a pull request to dev
.
Also, please do the following: Check in Github Actions.
Code formatting
pre-commit are used for source code formatting. Please check the official site and set it up to run with git hook.
Setup Example
$ pip install pre-commit
$ pre-commit --version
pre-commit 3.7.1
$ cd path/to/this_repo
$ pre-commit install
pre-commit installed at .git/hooks/pre-commit
Unit Tests
Please confirm that you can clear it by running it in one of the environments.
Windows
> .\scripts\unittest.bat path\to\Qt\6.8.1\msvc2022_64\bin
Ubuntu
$ ./scripts/unittest.sh linux path/to/Qt/6.8.1/gcc_64/bin
Mac
$ ./scripts/unittest.sh mac path/to/Qt/6.8.1/gcc_64/bin