最新のバイナリはreleasesからダウンロードできます。
- nodeのバージョン管理はfnmを使用した場合の手順を記載する。fnm以外を使用する場合は適宜読み替える事。
- PCにnode, nodist, Voltaがインストールされている場合、アンインストールする。
- 注意）nodistをアンインストールした後、$HOME.npmrc 内のnodistの記載を手動で削除する。
# fnmのインストール
winget install Schniz.fnm
# fnmの初期化（PowerShell）
## プロファイルを開く
notepad $PROFILE
## 以下の1行を追記
fnm env --use-on-cd | Out-String | Invoke-Expression
## 保存後に反映
. $PROFILE
# nodeのインストール
fnm install 22
fnm use 22
fnm default 22
# ライブラリなどのインストール
npm ci- Windows Git Bashを利用する場合は、以下を設定してください。
# .bashrcを開く
nano ~/.bashrc
# 以下の1行を追記して保存
eval "$(fnm env --use-on-cd)"- PCにnode, nodebrew, Voltaがインストールされている場合、アンインストールする
# fnmのインストール
brew install fnm
# fnmの初期化
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc
# nodeのインストール
fnm install 22
fnm use 22
fnm default 22
# ライブラリなどのインストール
npm ci# 開発モードで起動する
npm run app:dev
# プロダクト向けビルド
npm run app:build
⇒ releaseフォルダ配下にビルドされたファイルが出力されます。# すべてのUTを実行
npm run test
# ファイル指定
npm run test -- ファイル名の一部
例） npm run test -- CommonUtil_isEmpty
# テスト名指定
npm run test -- ファイル名の一部 -t "name"
例） npm run test -- CommonUtil_isEmpty -t "empty"VsCodeでのデバッグ実行の方法です。
npm run app:buildでビルドを行う。src\electron配下のファイルにブレークポイントを設定する。- 実行とデバッグ（
Run and Debug (Ctrl+Shift+D)）にて、Electron: Mainを選択する。 - F5でデバッグを開始する。
npm run app:devでアプリを起動する。src\renderer配下のファイルにブレークポイントを設定する。- 実行とデバッグ（
Run and Debug (Ctrl+Shift+D)）にて、Electron: Rendererを選択する。 - F5でデバッグを開始する。
- 機能拡張「Vitest Runner(firsttris.vscode-jest-runner)」をインストールする
- 適宜ブレークポイントを設定する。
- テストケースのファイルの各ケース（メソッド）の上部の「Debug」をクリックする
-
cmdプロンプトを管理者権限で起動する
-
npm run app:buildでビルドを行う。※以下が出力された場合
cannot execute cause=exit status 1 errorOut=Fatal error: Unable to commit changes以下フォルダを削除して、再度ビルドを行う。
C:/Users/user/AppData/Local/electron-builder
- WSL2（ubuntu）で本プロジェクトルートを開く
npm run app:build-linuxでビルドを行う。
Inkscapeで編集を行う。
- 小さいアイコン向け
- public\assets\アイコン_24.svg
- 大きいアイコン向け
- public\assets\アイコン_512.svg
複数pngをicoファイルに格納するため、以下からImageMagicをダウンロード、インストールする。
https://www.imagemagick.org/script/download.php
以下をコマンドプロンプトで実行する。
cd プロジェクトルート\public\assets
magick convert rst_icon_16.png rst_icon_24.png rst_icon_32.png rst_icon_48.png rst_icon_64.png rst_icon_128.png rst_icon_256.png rst.ico
以下のWarningが出力されるが無視する。
WARNING: The convert command is deprecated in IMv7, use "magick" instead of "convert" or "magick convert"
rst.ico がWindowsのアイコンファイルとなる。
- [Natural Earth III – Texture Maps]から地図画像データをDL
- 2. Earth without cloudsの[16,200 x 8,100 JPEG (30 MB)]をDLする。
- [Projection information and world (.tfw) files (4 KB)]をDLする。
※ 2. Earth without cloudsと同一ページの最下部にDLリンクあり。
- ファイル名変更&ユーザーフォルダ配下への格納
- [16,200 x 8,100 JPEG (30 MB)]のファイル名を[natural_earth.jpg]に変更する。
- [16200x8100.tfw]のファイル名を[natural_earth.tfw]に変更する。
- ユーザーフォルダ配下に[EPSG4326]フォルダを新規作成して、[natural_earth.jpg]、[natural_earth.tfw]を格納する。
-
以下からQGISをダウンロード、インストールする。
https://qgis.org/download/ -
OSGeo4W Shellを起動して地図タイルを生成
- 以下をOSGeo4W Shellで実行する。
cd C:\Users\ユーザーフォルダ\EPSG4326
gdal_translate -a_srs EPSG:4326 -a_ullr -180 90 180 -90 natural_earth.jpg temp.tif
gdalinfo temp.tif
gdal2tiles -p geodetic -z 1-6 --tilesize=512 --tiledriver=JPEG --jpeg-quality=85 temp.tif tiles
for /r "C:\Users\ユーザーフォルダ\EPSG4326\tiles" %f in (*.kml) do del "%f"
以下のようにエイリアスで記載するが、exe化後の実行時に "cannot find module" が発生する。 これに対処するため、tsc-aliasにて強制的に相対パスへ置換を行っている。
import AppMainLogger from "@/main/util/AppMainLogger.js";package.json
"scripts": {
"app:build": "npm run vite:build && tsc && npm run app:import-replace && electron-builder",
"app:import-replace": "tsc-alias -p tsconfig.json",
}以下箇所で相対パスへ置換を行っている。
"tsc-alias -p tsconfig.json"ログは、ユーザディレクトリ配下に出力される。
例）Windowsの場合
C:\Users\username\AppData\Roaming\rst\logs\rst.log
- ローテーションは10MB（Constant.tsで設定）
- ローテーションは１世代のみ保持される
バグ報告や改善要望は、GitHubのIssuesに登録ください。
The source code is licensed MIT.