mirror of
https://github.com/Minidoracat/mcp-feedback-enhanced.git
synced 2025-07-27 02:22:26 +08:00
438 lines
15 KiB
Python
438 lines
15 KiB
Python
#!/usr/bin/env python3
|
||
"""
|
||
桌面應用程式構建腳本
|
||
|
||
此腳本負責構建 Tauri 桌面應用程式和 Python 擴展模組，
|
||
確保在 PyPI 發布時包含預編譯的二進制檔案。
|
||
|
||
使用方法：
|
||
python scripts/build_desktop.py [--release] [--clean]
|
||
"""
|
||
|
||
import argparse
|
||
import os
|
||
import shutil
|
||
import subprocess
|
||
import sys
|
||
from pathlib import Path
|
||
|
||
|
||
def run_command(
|
||
cmd: list[str], cwd: str = None, check: bool = True, show_info: bool = True
|
||
) -> subprocess.CompletedProcess:
|
||
"""執行命令並返回結果"""
|
||
if show_info:
|
||
print(f"🔧 執行命令: {' '.join(cmd)}")
|
||
if cwd:
|
||
print(f"📁 工作目錄: {cwd}")
|
||
|
||
result = subprocess.run(cmd, cwd=cwd, capture_output=True, text=True, check=False)
|
||
|
||
# 處理標準輸出
|
||
if result.stdout and show_info:
|
||
print("📤 輸出:")
|
||
print(result.stdout.strip())
|
||
|
||
# 智能處理標準錯誤 - 區分信息和真正的錯誤
|
||
if result.stderr:
|
||
stderr_lines = result.stderr.strip().split("\n")
|
||
info_lines = []
|
||
error_lines = []
|
||
|
||
for line in stderr_lines:
|
||
stripped_line = line.strip()
|
||
if not stripped_line:
|
||
continue
|
||
# 識別信息性消息和正常編譯輸出
|
||
if (
|
||
stripped_line.startswith("info:")
|
||
or "is up to date" in stripped_line
|
||
or "downloading component" in stripped_line
|
||
or "installing component" in stripped_line
|
||
or stripped_line.startswith("Compiling")
|
||
or stripped_line.startswith("Finished")
|
||
or stripped_line.startswith("Building")
|
||
or "target(s) in" in stripped_line
|
||
):
|
||
info_lines.append(stripped_line)
|
||
else:
|
||
error_lines.append(stripped_line)
|
||
|
||
# 顯示信息性消息
|
||
if info_lines and show_info:
|
||
print("ℹ️ 信息:")
|
||
for line in info_lines:
|
||
print(f" {line}")
|
||
|
||
# 顯示真正的錯誤
|
||
if error_lines:
|
||
print("❌ 錯誤:")
|
||
for line in error_lines:
|
||
print(f" {line}")
|
||
|
||
if check and result.returncode != 0:
|
||
raise subprocess.CalledProcessError(result.returncode, cmd)
|
||
|
||
return result
|
||
|
||
|
||
def check_rust_environment():
|
||
"""檢查 Rust 開發環境"""
|
||
print("🔍 檢查 Rust 開發環境...")
|
||
|
||
try:
|
||
result = run_command(["rustc", "--version"])
|
||
print(f"✅ Rust 編譯器: {result.stdout.strip()}")
|
||
except (subprocess.CalledProcessError, FileNotFoundError):
|
||
print("❌ 未找到 Rust 編譯器")
|
||
print("💡 請安裝 Rust: https://rustup.rs/")
|
||
return False
|
||
|
||
try:
|
||
result = run_command(["cargo", "--version"])
|
||
print(f"✅ Cargo: {result.stdout.strip()}")
|
||
except (subprocess.CalledProcessError, FileNotFoundError):
|
||
print("❌ 未找到 Cargo")
|
||
return False
|
||
|
||
try:
|
||
result = run_command(["cargo", "install", "--list"])
|
||
if "tauri-cli" in result.stdout:
|
||
print("✅ Tauri CLI 已安裝")
|
||
else:
|
||
print("⚠️ Tauri CLI 未安裝，嘗試安裝...")
|
||
run_command(["cargo", "install", "tauri-cli"])
|
||
print("✅ Tauri CLI 安裝完成")
|
||
except subprocess.CalledProcessError:
|
||
print("❌ 無法安裝 Tauri CLI")
|
||
return False
|
||
|
||
return True
|
||
|
||
|
||
def install_rust_targets():
|
||
"""安裝跨平台編譯所需的 Rust targets"""
|
||
print("🎯 安裝跨平台編譯 targets...")
|
||
|
||
# 定義需要的 targets
|
||
targets = [
|
||
("x86_64-pc-windows-msvc", "Windows x64"),
|
||
("x86_64-apple-darwin", "macOS Intel"),
|
||
("aarch64-apple-darwin", "macOS Apple Silicon"),
|
||
("x86_64-unknown-linux-gnu", "Linux x64"),
|
||
]
|
||
|
||
installed_count = 0
|
||
updated_count = 0
|
||
|
||
for target, description in targets:
|
||
print(f"📦 檢查 target: {target} ({description})")
|
||
try:
|
||
result = run_command(
|
||
["rustup", "target", "add", target], check=False, show_info=False
|
||
)
|
||
|
||
if result.returncode == 0:
|
||
# 檢查是否是新安裝還是已存在
|
||
if "is up to date" in result.stderr:
|
||
print(f"✅ {description} - 已是最新版本")
|
||
updated_count += 1
|
||
elif "installing component" in result.stderr:
|
||
print(f"🆕 {description} - 新安裝完成")
|
||
installed_count += 1
|
||
else:
|
||
print(f"✅ {description} - 安裝成功")
|
||
installed_count += 1
|
||
else:
|
||
print(f"⚠️ {description} - 安裝失敗")
|
||
if result.stderr:
|
||
print(f" 錯誤: {result.stderr.strip()}")
|
||
except Exception as e:
|
||
print(f"⚠️ 安裝 {description} 時發生錯誤: {e}")
|
||
|
||
print(
|
||
f"✅ Rust targets 檢查完成 (新安裝: {installed_count}, 已存在: {updated_count})"
|
||
)
|
||
|
||
|
||
def clean_build_artifacts(project_root: Path):
|
||
"""清理構建產物"""
|
||
print("🧹 清理構建產物...")
|
||
|
||
# 清理 Rust 構建產物
|
||
rust_target = project_root / "src-tauri" / "target"
|
||
if rust_target.exists():
|
||
print(f"清理 Rust target 目錄: {rust_target}")
|
||
shutil.rmtree(rust_target)
|
||
|
||
# 清理 Python 構建產物
|
||
python_build_dirs = [
|
||
project_root / "build",
|
||
project_root / "dist",
|
||
project_root / "*.egg-info",
|
||
]
|
||
|
||
for build_dir in python_build_dirs:
|
||
if build_dir.exists():
|
||
print(f"清理 Python 構建目錄: {build_dir}")
|
||
if build_dir.is_dir():
|
||
shutil.rmtree(build_dir)
|
||
else:
|
||
build_dir.unlink()
|
||
|
||
|
||
def build_rust_extension(project_root: Path, release: bool = True):
|
||
"""構建 Rust 擴展模組"""
|
||
print("🔨 構建 Rust 擴展模組...")
|
||
|
||
src_tauri = project_root / "src-tauri"
|
||
if not src_tauri.exists():
|
||
raise FileNotFoundError(f"src-tauri 目錄不存在: {src_tauri}")
|
||
|
||
# 構建 Rust 庫
|
||
build_cmd = ["cargo", "build"]
|
||
if release:
|
||
build_cmd.append("--release")
|
||
|
||
run_command(build_cmd, cwd=str(src_tauri))
|
||
print("✅ Rust 擴展模組構建完成")
|
||
|
||
|
||
def build_tauri_app_multiplatform(project_root: Path, release: bool = True):
|
||
"""構建多平台 Tauri 桌面應用程式"""
|
||
print("🖥️ 構建多平台 Tauri 桌面應用程式...")
|
||
|
||
src_tauri = project_root / "src-tauri"
|
||
|
||
# 定義目標平台
|
||
targets = [
|
||
("x86_64-pc-windows-msvc", "mcp-feedback-enhanced-desktop.exe"),
|
||
("x86_64-apple-darwin", "mcp-feedback-enhanced-desktop"),
|
||
("aarch64-apple-darwin", "mcp-feedback-enhanced-desktop"),
|
||
("x86_64-unknown-linux-gnu", "mcp-feedback-enhanced-desktop"),
|
||
]
|
||
|
||
successful_builds = []
|
||
|
||
# 平台描述映射
|
||
platform_descriptions = {
|
||
"x86_64-pc-windows-msvc": "Windows x64",
|
||
"x86_64-apple-darwin": "macOS Intel",
|
||
"aarch64-apple-darwin": "macOS Apple Silicon",
|
||
"x86_64-unknown-linux-gnu": "Linux x64",
|
||
}
|
||
|
||
for target, binary_name in targets:
|
||
description = platform_descriptions.get(target, target)
|
||
print(f"🔨 構建 {description} ({target})...")
|
||
|
||
# 構建命令
|
||
build_cmd = [
|
||
"cargo",
|
||
"build",
|
||
"--bin",
|
||
"mcp-feedback-enhanced-desktop",
|
||
"--target",
|
||
target,
|
||
]
|
||
if release:
|
||
build_cmd.append("--release")
|
||
|
||
try:
|
||
run_command(build_cmd, cwd=str(src_tauri), show_info=False)
|
||
successful_builds.append((target, binary_name))
|
||
print(f"✅ {description} 構建成功")
|
||
except subprocess.CalledProcessError as e:
|
||
print(f"⚠️ {description} 構建失敗")
|
||
print("💡 可能缺少該平台的編譯工具鏈或依賴")
|
||
# 顯示具體錯誤信息
|
||
if hasattr(e, "stderr") and e.stderr:
|
||
print(f" 錯誤詳情: {e.stderr.strip()}")
|
||
except Exception as e:
|
||
print(f"❌ {description} 構建時發生未預期錯誤: {e}")
|
||
|
||
if successful_builds:
|
||
print(f"✅ 成功構建 {len(successful_builds)} 個平台")
|
||
|
||
# 如果只構建了當前平台，給出提示
|
||
if len(successful_builds) == 1:
|
||
print("")
|
||
print("💡 注意：只成功構建了當前平台的二進制文件")
|
||
print(" 其他平台的構建失敗通常是因為缺少跨平台編譯工具鏈")
|
||
print(" 完整的多平台支援將在 GitHub Actions CI 中完成")
|
||
print(" 發佈到 PyPI 時會包含所有平台的二進制文件")
|
||
|
||
return successful_builds
|
||
print("❌ 所有平台構建都失敗了")
|
||
return []
|
||
|
||
|
||
def copy_multiplatform_artifacts(
|
||
project_root: Path, successful_builds: list, release: bool = True
|
||
):
|
||
"""複製多平台構建產物到適當位置"""
|
||
print("📦 複製多平台構建產物...")
|
||
|
||
src_tauri = project_root / "src-tauri"
|
||
build_type = "release" if release else "debug"
|
||
|
||
# 創建目標目錄
|
||
desktop_dir = project_root / "src" / "mcp_feedback_enhanced" / "desktop_release"
|
||
desktop_dir.mkdir(parents=True, exist_ok=True)
|
||
|
||
# 定義平台到文件名的映射
|
||
platform_mapping = {
|
||
"x86_64-pc-windows-msvc": "mcp-feedback-enhanced-desktop.exe",
|
||
"x86_64-apple-darwin": "mcp-feedback-enhanced-desktop-macos-intel",
|
||
"aarch64-apple-darwin": "mcp-feedback-enhanced-desktop-macos-arm64",
|
||
"x86_64-unknown-linux-gnu": "mcp-feedback-enhanced-desktop-linux",
|
||
}
|
||
|
||
copied_files = []
|
||
|
||
for target, original_binary_name in successful_builds:
|
||
# 源文件路徑
|
||
src_file = src_tauri / "target" / target / build_type / original_binary_name
|
||
|
||
# 目標文件名
|
||
dst_filename = platform_mapping.get(target, original_binary_name)
|
||
dst_file = desktop_dir / dst_filename
|
||
|
||
if src_file.exists():
|
||
shutil.copy2(src_file, dst_file)
|
||
# 設置執行權限（非 Windows）
|
||
# 0o755 權限是必要的，因為這些是可執行的二進制檔案
|
||
if not dst_filename.endswith(".exe"):
|
||
os.chmod(dst_file, 0o755) # noqa: S103
|
||
copied_files.append(dst_filename)
|
||
print(f"✅ 複製 {target} 二進制檔案: {src_file} -> {dst_file}")
|
||
else:
|
||
print(f"⚠️ 找不到 {target} 的二進制檔案: {src_file}")
|
||
|
||
if not copied_files:
|
||
print("⚠️ 沒有找到可複製的二進制檔案")
|
||
return False
|
||
|
||
# 創建 __init__.py 文件，讓 desktop 目錄成為 Python 包
|
||
desktop_init = desktop_dir / "__init__.py"
|
||
if not desktop_init.exists():
|
||
desktop_init.write_text('"""桌面應用程式二進制檔案"""', encoding="utf-8")
|
||
print(f"✅ 創建 __init__.py: {desktop_init}")
|
||
|
||
print(f"✅ 成功複製 {len(copied_files)} 個平台的二進制檔案")
|
||
return True
|
||
|
||
|
||
def copy_desktop_python_module(project_root: Path):
|
||
"""複製桌面應用 Python 模組到發佈位置"""
|
||
print("📦 複製桌面應用 Python 模組...")
|
||
|
||
# 源路徑和目標路徑
|
||
python_src = project_root / "src-tauri" / "python" / "mcp_feedback_enhanced_desktop"
|
||
python_dst = project_root / "src" / "mcp_feedback_enhanced" / "desktop_app"
|
||
|
||
if not python_src.exists():
|
||
print(f"⚠️ 源模組不存在: {python_src}")
|
||
return False
|
||
|
||
# 如果目標目錄存在，先刪除
|
||
if python_dst.exists():
|
||
shutil.rmtree(python_dst)
|
||
print(f"🗑️ 清理舊的模組目錄: {python_dst}")
|
||
|
||
# 複製模組
|
||
shutil.copytree(python_src, python_dst)
|
||
print(f"✅ 複製桌面應用模組: {python_src} -> {python_dst}")
|
||
|
||
return True
|
||
|
||
|
||
def main():
|
||
"""主函數"""
|
||
parser = argparse.ArgumentParser(
|
||
description="構建 MCP Feedback Enhanced 桌面應用程式",
|
||
formatter_class=argparse.RawDescriptionHelpFormatter,
|
||
epilog="""
|
||
範例:
|
||
python scripts/build_desktop.py # 構建 Debug 版本
|
||
python scripts/build_desktop.py --release # 構建 Release 版本
|
||
python scripts/build_desktop.py --clean # 清理構建產物
|
||
|
||
構建完成後，可以使用以下命令測試:
|
||
python -m mcp_feedback_enhanced test --desktop
|
||
|
||
或使用 Makefile:
|
||
make build-desktop # 構建 Debug 版本
|
||
make build-desktop-release # 構建 Release 版本
|
||
make test-desktop # 構建並測試
|
||
""",
|
||
)
|
||
parser.add_argument(
|
||
"--release", action="store_true", help="構建發布版本 (預設為 Debug)"
|
||
)
|
||
parser.add_argument("--clean", action="store_true", help="清理構建產物")
|
||
|
||
args = parser.parse_args()
|
||
|
||
# 獲取專案根目錄
|
||
project_root = Path(__file__).parent.parent.resolve()
|
||
print(f"專案根目錄: {project_root}")
|
||
|
||
try:
|
||
# 清理構建產物（如果需要）
|
||
if args.clean:
|
||
clean_build_artifacts(project_root)
|
||
|
||
# 檢查 Rust 環境
|
||
if not check_rust_environment():
|
||
sys.exit(1)
|
||
|
||
# 安裝跨平台編譯 targets
|
||
install_rust_targets()
|
||
|
||
# 構建 Rust 擴展
|
||
build_rust_extension(project_root, args.release)
|
||
|
||
# 構建多平台 Tauri 應用程式
|
||
successful_builds = build_tauri_app_multiplatform(project_root, args.release)
|
||
|
||
if not successful_builds:
|
||
print("❌ 沒有成功構建任何平台")
|
||
sys.exit(1)
|
||
|
||
# 複製多平台構建產物
|
||
if not copy_multiplatform_artifacts(
|
||
project_root, successful_builds, args.release
|
||
):
|
||
print("⚠️ 構建產物複製失敗，但 Rust 編譯成功")
|
||
return
|
||
|
||
# 複製桌面應用 Python 模組
|
||
if not copy_desktop_python_module(project_root):
|
||
print("⚠️ 桌面應用模組複製失敗")
|
||
return
|
||
|
||
print("🎉 多平台桌面應用程式構建完成！")
|
||
print("")
|
||
print("📍 構建產物位置:")
|
||
print(" 多平台二進制檔案: src/mcp_feedback_enhanced/desktop_release/")
|
||
print(" 桌面應用模組: src/mcp_feedback_enhanced/desktop_app/")
|
||
print(" 開發環境模組: src-tauri/python/mcp_feedback_enhanced_desktop/")
|
||
print("")
|
||
print("🌍 支援的平台:")
|
||
for target, _ in successful_builds:
|
||
print(f" ✅ {target}")
|
||
print("")
|
||
print("🚀 下一步:")
|
||
print(" 測試桌面應用程式: python -m mcp_feedback_enhanced test --desktop")
|
||
print(" 或使用 Makefile: make test-desktop")
|
||
print(" 構建發布包: make build-all")
|
||
|
||
except Exception as e:
|
||
print(f"❌ 構建失敗: {e}")
|
||
sys.exit(1)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|