脚本目录重组与文档清理记录

StoreX Flutter Android Windows Linux 架构
February 3, 2026
2 min read
By devshan

Table of Contents

This is a list of all the sections in this post. Click on any of them to jump to that section.

背景与问题

  • 脚本目录按系统拆分（windows/linux/macos）导致重复与维护分叉。
  • README 与多份构建文档引用路径不一致，易导致脚本找不到。
  • .gitignore 包含大量与项目无关的忽略项，噪声大、可读性差。
  • 项目根目录缺少统一的 README 入口说明。

本次改动

  • 脚本目录重组
    • 统一为 scripts/bat 与 scripts/sh 两类目录。
    • Windows 相关脚本移至 scripts/bat。
    • Linux/macOS 共享同一套 scripts/sh 脚本。
  • 新增 Android bash 脚本
    • 新增 build_android.sh 与 run_android.sh，基于环境变量 ANDROID_HOME/ANDROID_NDK_HOME。
  • 文档与 README 同步
    • 更新所有脚本引用路径，统一指向 scripts/bat 与 scripts/sh。
    • README 增加构建入口列表与文档索引。
  • .gitignore 精简
    • 移除无关忽略项，仅保留 Flutter/Android 构建产物、IDE、常见 OS 垃圾文件。
  • content 文档纳入版本控制
    • 架构与设计文档统一进入仓库，作为可追踪资料。

行为变化

  • 旧路径 scripts/windows/*、scripts/linux/*、scripts/macos/* 已失效。
  • 构建与调试脚本统一入口：
    • Windows：scripts/bat/*.bat
    • Linux/macOS：scripts/sh/*.sh

风险与待补

  • 外部 CI 或本地脚本若硬编码旧路径会失效，需要同步更新。
  • .gitignore 精简后若有遗留新产物未覆盖，可能被误提交（需留意）。

验证建议

  1. Windows：运行 scripts/bat/build_windows.bat 与 scripts/bat/run_windows.bat。
  2. Android：运行 scripts/bat/build_android.bat 或 scripts/sh/build_android.sh。
  3. 抽查 README 与构建文档链接是否可直达脚本路径。

相关文件

  • scripts/bat/build_windows.bat、scripts/bat/run_windows.bat
  • scripts/bat/build_android.bat、scripts/bat/run_android.bat
  • scripts/sh/build_android.sh、scripts/sh/run_android.sh
  • README.md
  • content/构建与部署/构建与部署.md
  • .gitignore