跳转到内容

更新代码库

ShipSaaS 会保持定期更新、错误修复和安全补丁,本文档介绍如何将您的项目更新到最新版本。

您可以将您的代码库更新到最新版本。需要注意,您对应用程序进行的自定义越多,更新过程就越复杂。更新涉及使用 Git 将最新的 ShipSaaS 模板代码与您的更改合并,因此可能需要仔细解决合并冲突以保留您的自定义代码。

如果您使用 Git 仓库开始项目,您可以直接拉取更新。

# 添加模板项目仓库为上游远程仓库
git remote add upstream https://github.com/ShipSaaS/shipsaas.git
# 获取模板最新更改
git fetch upstream
# 为更新创建新分支
git checkout -b update-template
# 合并更改(如有必要解决冲突)
git merge upstream/main

安装新的项目依赖:

bun install

当更新包含数据库模式更改时:

  1. 检查 src/db/schema.ts 文件中的数据库模式更改
  2. 生成数据库迁移文件:
bun run db:generate
  1. 应用迁移到数据库:
# 应用到本地 D1 数据库
bun run db:migrate:local
# 应用到远程 D1 数据库
bun run db:migrate:remote

如果您在快速开始中已经将项目关联到自己的 GitHub 仓库,合并完成后可以将更新推送到您的远程仓库:

# 推送更新分支到您的远程仓库
git push origin update-template
# 合并到主分支后推送
git checkout main
git merge update-template
git push origin main

更新后,彻底测试您的应用程序:

  1. 运行开发服务器:
bun run dev
  1. 检查控制台错误
  2. 测试关键用户操作流程
  3. 运行代码检查和格式化:
bun run lint
bun run format
  1. 检查构建是否成功:
bun run build

要接收 ShipSaaS 的更新通知:

  1. 关注 GitHub 仓库
  2. 关注 X 账号 @ShipSaaS

现在您了解了如何保持您的 ShipSaaS 项目最新,探索这些相关主题: