ビルド手順

ノート🇺🇸 English Version / Available in English

For the English version, please refer to the Build Instructions page.

注意

このページの内容は開発者の方向けです。

本ページでは、アプリケーションのビルド手順について説明します。
本アプリケーションは PyInstaller を用いてビルドしています。

pyinstaller build.spec

重要ドキュメントサイトの公開（GitHub Pages）

ドキュメントサイトは GitHub Actions で自動ビルド・公開します。

• ワークフロー: .github/workflows/deploy-pages.yml
• 実行条件:
  • pull_request: Quarto のビルド確認のみ（デプロイなし）
  • main への push: Quarto ビルド + GitHub Pages デプロイ

初回設定として、リポジトリ管理者が以下を設定してください。 Settings → Pages → Source = GitHub Actions

重要安定版スタンドアローン配布（Windows/macOS/Linux）

v1.0.0 以降は、GitHub Actions で 3OS 向けの配布物を自動生成します。

• ワークフロー: .github/workflows/release-standalone.yml
• 実行条件:
  • pull_request / main への push: ビルド検証のみ
  • v1.0.0 のようなタグ push: ビルド + GitHub Release 公開
• 生成物:
  • LeafContourEFD-windows-x64.zip
  • LeafContourEFD-macos-arm64.tar.gz
  • LeafContourEFD-macos-x64.tar.gz
  • LeafContourEFD-ubuntu-x64.tar.gz

生成物は GitHub Release に添付されます。 Releaseノートには、各アーカイブ内の実行ファイルから自動検出したCPUアーキテクチャ一覧も追記されます。

ヒント古いビルド成果物の削除

# PowerShell
Remove-Item -Recurse -Force build, dist

# Bash
rm -rf build dist

ビルド後の構成

project/
├─ build/
└─ dist/
   └─ LeafContourEFD/
      ├─ LeafContourEFD(.exe)
      └─ _internal/
         └─ (ライブラリ群)

注意

安定性のため onefile ではなく onedir モードで配布しています。
dist/LeafContourEFD/ フォルダ全体を配布してください。