openclaw/translation/vietnamese/docs/reference/RELEASING.vi.md

summary	read_when
Danh sách kiểm tra quy trình phát hành từng bước cho gói npm và ứng dụng macOS	Bạn chuẩn bị phát hành một phiên bản npm mới Bạn phát hành bản cập nhật cho ứng dụng macOS

Danh sách kiểm tra Phát hành (npm + macOS)

Sử dụng pnpm (Node 22+) từ thư mục gốc của kho mã nguồn. Đảm bảo mọi thay đổi đã được commit sạch sẽ trước khi gắn thẻ (tag) hoặc phát hành.

Các bước thực hiện

1. Phiên bản & Dữ liệu mô tả

• Cập nhật số phiên bản trong package.json (ví dụ: 2026.1.27-beta.1).
• Chạy pnpm plugins:sync để đồng bộ phiên bản của các tiện ích mở rộng.
• Kiểm tra lại các thông tin mô tả gói (tên, giấy phép, các tệp nhị phân).

2. Xây dựng bản dựng (Build)

• Chạy pnpm run build để tạo lại thư mục dist/.
• Xác nhận các thư mục quan trọng như dist/node-host/ đã được bao gồm.
• Kiểm tra sự tồn tại của tệp dist/build-info.json.

3. Nhật ký thay đổi (Changelog)

• Cập nhật tệp CHANGELOG.md với các điểm nổi bật dành cho người dùng.
• Đảm bảo các ví dụ trong README vẫn đúng với hành vi mới của CLI.

4. Kiểm chứng (Validation)

• Chạy pnpm lint và pnpm test.
• Chạy bài kiểm tra cài đặt thử nghiệm: pnpm test:install:smoke.

5. Ứng dụng macOS (Sparkle)

• Biên dịch và ký tên ứng dụng Mac, sau đó đóng gói dạng ZIP.
• Tạo tệp tin appcast.xml cho hệ thống tự động cập nhật Sparkle.
• Thực hiện các bước ký tên và xác thực (notarization) theo Hướng dẫn phát hành Mac.

6. Phát hành lên npm

• npm login và kiểm tra xác thực 2 lớp (2FA).
• Chạy npm publish --access public.

7. Phát hành lên GitHub

• Gắn thẻ phiên bản: git tag vX.Y.Z && git push origin vX.Y.Z.
• Tạo Release trên GitHub với tiêu đề và nội dung nhật ký thay đổi đầy đủ.
• Đính kèm các tệp ZIP của ứng dụng Mac và gói npm vào Release.

---

Tài liệu liên quan: Phát hành Mac, Thiết lập nhà phát triển.