Triển khai dự án Google Apps Script là một bản phát hành tập lệnh của bạn, có thể dùng làm ứng dụng web, tiện ích bổ sung cho Google Workspace hoặc tệp thực thi API. Bằng cách tạo và quản lý các bản triển khai, bạn có thể lặp lại mã và kiểm soát phiên bản tập lệnh mà người dùng truy cập.
Có 2 loại bản triển khai:
- Bản triển khai tiêu đề luôn đồng bộ hoá với mã dự án hiện tại.
- Bản triển khai theo phiên bản kết nối với một phiên bản dự án cụ thể.
Bản triển khai tiêu đề
Bản triển khai tiêu đề là mã dự án hiện tại. Khi bạn tạo một dự án Apps Script, hệ thống sẽ tự động tạo một bản triển khai tiêu đề cho dự án đó.
Bản triển khai tiêu đề luôn đồng bộ hoá với mã được lưu gần đây nhất. Ví dụ: nếu bạn tạo một bản triển khai theo phiên bản rồi sửa đổi mã, thì bản triển khai tiêu đề sẽ phản ánh những thay đổi đó trong khi bản triển khai theo phiên bản vẫn giữ nguyên.
Sử dụng bản triển khai tiêu đề để kiểm thử mã. Không sử dụng bản triển khai tiêu đề cho mục đích sử dụng công khai.
Chỉ có một bản triển khai tiêu đề cho mỗi dự án Apps Script. Để sử dụng bản triển khai tiêu đề, bạn phải có ít nhất quyền truy cập để đọc dự án tập lệnh.
Bản triển khai theo phiên bản
Bản triển khai theo phiên bản cung cấp một phiên bản cụ thể của mã dự án. Điều này cho phép người dùng tiếp tục sử dụng một phiên bản đang hoạt động trong khi bạn thực hiện các thay đổi và cải tiến đối với mã.
Khi xuất bản một ứng dụng để sử dụng công khai, hãy luôn sử dụng bản triển khai theo phiên bản. Bạn có thể có nhiều bản triển khai theo phiên bản đang hoạt động cùng một lúc.
Quan trọng: Bạn không thể chuyển quyền sở hữu bản triển khai theo phiên bản. Nếu bạn chuyển quyền sở hữu một dự án tập lệnh, thì chủ sở hữu của các bản triển khai theo phiên bản hiện có sẽ không thay đổi. Nếu quản trị viên xoá tài khoản của chủ sở hữu bản triển khai, thì các bản triển khai của họ có thể gặp lỗi tập lệnh.
Bản triển khai so với phiên bản
Phiên bản và bản triển khai là các khái niệm riêng biệt trong Apps Script:
- Phiên bản: Ảnh chụp nhanh tĩnh của mã dự án tập lệnh. Sau khi được tạo, phiên bản sẽ không thể thay đổi. Hãy xem phiên bản là "điểm lưu" trong nhật ký phát triển.
- Bản triển khai: Bản phát hành giúp người dùng sử dụng một phiên bản cụ thể của tập lệnh. Bản triển khai có một URL hoặc mã nhận dạng duy nhất.
Khi muốn cập nhật mã mà một bản triển khai hiện có sử dụng (chẳng hạn như ứng dụng web ), bạn sẽ tạo một phiên bản mới, sau đó chỉnh sửa bản triển khai để trỏ đến phiên bản mới đó. Thao tác này sẽ cập nhật ứng dụng cho tất cả người dùng trong khi vẫn duy trì cùng một URL hoặc mã nhận dạng bản triển khai.
Tạo bản triển khai theo phiên bản
Để triển khai một phiên bản của tiện ích bổ sung, tiện ích bổ sung của Trình chỉnh sửa, ứng dụng Chat hoặc tệp thực thi API, trước tiên, bạn phải chuyển đổi mối liên kết dự án trên đám mây Google Cloud của Apps Script từ dự án mặc định sang dự án tiêu chuẩn.
Cách tạo bản triển khai theo phiên bản:
- Mở dự án Apps Script.
- Ở trên cùng bên phải, hãy nhấp vào Triển khai > Bản triển khai mới.
- Bên cạnh Chọn loại , hãy nhấp vào biểu tượng Bật chế độ cài đặt loại bản triển khai .
- Chọn loại bản triển khai mà bạn muốn triển khai. Đối với tiện ích bổ sung cho Google Workspace, tiện ích bổ sung của Trình chỉnh sửa và ứng dụng Google Chat, hãy chọn Tiện ích bổ sung.
- Nhập thông tin về bản triển khai rồi nhấp vào Triển khai.
Bạn có thể chia sẻ mỗi bản triển khai mới dưới dạng thư viện. Nếu bạn chia sẻ tập lệnh dưới dạng thư viện, thì người dùng thư viện có thể xem nội dung mô tả bản triển khai.
Xem bản triển khai theo phiên bản
Để xem các bản triển khai của một dự án Apps Script, ở trên cùng, hãy nhấp vào Triển khai > Quản lý các bản triển khai.
Để xem mã của một phiên bản cụ thể, hãy tham khảo bài viết Xem phiên bản trước.
Chỉnh sửa bản triển khai theo phiên bản
Bạn có thể chỉnh sửa bản triển khai theo phiên bản để thay đổi nội dung mô tả hoặc phiên bản. Cách chỉnh sửa bản triển khai:
- Mở dự án Apps Script.
- Nhấp vào Triển khai > Quản lý các bản triển khai.
- Chọn bản triển khai đang hoạt động rồi nhấp vào Chỉnh sửa .
- Thực hiện các thay đổi rồi nhấp vào Triển khai.
Để chỉnh sửa bản triển khai đã lưu trữ, hãy triển khai lại bản triển khai đó rồi làm theo các bước trước đó.
Để triển khai thay đổi đối với mã dự án, hãy tạo một phiên bản mới và chỉnh sửa bản triển khai để sử dụng phiên bản đó. Đây là cách tiêu chuẩn để cập nhật ứng dụng mà không thay đổi URL hoặc mã nhận dạng bản triển khai. Bản triển khai sẽ tự động sử dụng phiên bản mới cho tất cả người dùng.
Tìm mã nhận dạng bản triển khai
Mỗi bản triển khai đều có một mã nhận dạng chuỗi được liên kết. Cách tìm mã nhận dạng này:
- Mở dự án Apps Script.
- Ở trên cùng bên phải, hãy nhấp vào Triển khai > Quản lý các bản triển khai.
- Chọn một bản triển khai đang hoạt động để tìm mã nhận dạng của bản triển khai đó.
Mã nhận dạng bản triển khai chỉ xuất hiện trên các bản triển khai đang hoạt động.
Kiểm thử bản triển khai
Phương thức kiểm thử bản triển khai tuỳ thuộc vào loại ứng dụng mà bạn tạo.
Tiện ích bổ sung cho Google Workspace
Để kiểm thử bản triển khai tiện ích bổ sung, hãy xem bài viết Kiểm thử tiện ích bổ sung.
Tiện ích bổ sung của Trình chỉnh sửa
Để kiểm thử bản triển khai tiện ích bổ sung của Trình chỉnh sửa, hãy xem bài viết Kiểm thử tiện ích bổ sung của Trình chỉnh sửa.
Ứng dụng web
Để kiểm thử bản triển khai ứng dụng web, hãy xem bài viết Kiểm thử bản triển khai ứng dụng web.
Ứng dụng Google Chat
Để kiểm thử bản triển khai ứng dụng Chat, hãy tạo bản triển khai theo phiên bản của tập lệnh để truy cập vào mã nhận dạng bản triển khai.
Sau khi có mã nhận dạng bản triển khai, hãy chỉ định mã nhận dạng đó trong cấu hình Chat API và làm theo các bước để kiểm thử các tính năng tương tác.
API có thể thực thi
Để kiểm thử bản triển khai API có thể thực thi, hãy tạo bản triển khai theo phiên bản. Sau khi tạo bản triển khai, hãy làm theo các bước sau:
- Ở trên cùng bên phải của dự án Apps Script, hãy nhấp vào Triển khai > Kiểm thử các bản triển khai.
- Bên cạnh "Chọn loại", hãy nhấp vào biểu tượng
> API có thể thực thi. - Sao chép và sử dụng URL để kiểm thử bản triển khai API có thể thực thi.
Lưu trữ bản triển khai theo phiên bản
Bạn không thể xoá bản triển khai theo phiên bản khỏi bản ghi các bản triển khai. Thay vào đó, bạn có thể lưu trữ các bản triển khai đó.
Cách lưu trữ bản triển khai theo phiên bản:
- Mở dự án Apps Script.
- Nhấp vào Triển khai > Quản lý các bản triển khai.
- Chọn bản triển khai rồi nhấp vào Lưu trữ bản triển khai .
Xoá phiên bản khỏi nhật ký dự án
Mặc dù không thể xoá bản triển khai theo phiên bản, nhưng bạn có thể xoá các phiên bản tập lệnh mà bản triển khai đó sử dụng khỏi nhật ký dự án. Để xoá một phiên bản, phiên bản đó không được một bản triển khai đang hoạt động sử dụng.
Để xoá một phiên bản, hãy tham khảo bài viết Xoá phiên bản.
Triển khai lại bản triển khai đã lưu trữ
- Mở dự án Apps Script.
- Ở trên cùng bên phải, hãy nhấp vào Triển khai > Quản lý các bản triển khai.
- Trong phần Đã lưu trữ, hãy chọn bản triển khai rồi nhấp vào Chỉnh sửa > Triển khai.