Bạn nên kiểm thử kỹ lưỡng các tiện ích bổ sung trước khi xuất bản để đảm bảo chúng hoạt động như dự kiến. Apps Script cho phép bạn kiểm thử tiện ích bổ sung cho Trình chỉnh sửa đang được phát triển trên các tệp Google Tài liệu, Trang tính, Biểu mẫu hoặc Trang trình bày cụ thể. Bạn có thể dùng tính năng này để:
- Xác minh rằng một tiện ích bổ sung được viết trong một tập lệnh độc lập hoạt động như dự kiến khi được áp dụng cho một trang tính, tài liệu, bản trình bày hoặc biểu mẫu.
- Xác minh rằng quy trình cài đặt tiện ích bổ sung hoạt động như dự kiến, đặc biệt là đối với các trạng thái vòng đời uỷ quyền ban đầu khác nhau (đã cài đặt, đã bật hoặc cả hai).
- Xác minh rằng tiện ích bổ sung hoạt động như dự kiến khi tác động lên một tài liệu cụ thể và nội dung của tài liệu đó.
- Kiểm thử và so sánh phiên bản hiện tại với phiên bản trước của tiện ích bổ sung.
Tạo một bản triển khai kiểm thử
Việc triển khai thử nghiệm là sự kết hợp giữa một tiện ích bổ sung và một tài liệu kiểm thử. Sau khi bạn phát triển một phiên bản tập lệnh và muốn kiểm thử phiên bản đó dưới dạng tiện ích bổ sung, hãy làm theo các bước sau:
- Nếu chưa có, hãy tạo một bảng tính, tài liệu, bản trình bày hoặc biểu mẫu để kiểm thử tiện ích bổ sung.
- Mở dự án tập lệnh chứa tiện ích bổ sung của bạn.
- Nhấp vào Triển khai > Kiểm thử việc triển khai.
- Bên cạnh Chọn loại, hãy nhấp vào Bật các loại triển khai rồi chọn Tiện ích bổ sung của trình chỉnh sửa.
- Nhấp vào Tạo thử nghiệm mới hoặc Thêm thử nghiệm.
- Chọn một phiên bản mã hoặc chọn Mã mới nhất.
- Trong phần Config (Cấu hình), hãy chọn trạng thái uỷ quyền ban đầu cho thử nghiệm.
- Trong mục Tài liệu kiểm thử, hãy nhấp vào Chưa chọn tài liệu nào. Chọn tệp Trang tính, Tài liệu, Trang trình bày hoặc Biểu mẫu mà bạn muốn dùng để kiểm thử tiện ích bổ sung rồi nhấp vào Chèn.
- Nhấp vào Lưu bài kiểm tra.
Tất cả các bản triển khai kiểm thử đã lưu sẽ xuất hiện trong hộp thoại Triển khai kiểm thử. Điều này cho phép bạn xem lại cùng một hoạt động triển khai kiểm thử sau này.
Chạy quy trình triển khai thử nghiệm
Nếu có một hoặc nhiều bản triển khai kiểm thử đã lưu, bạn có thể chạy một trong số đó bằng cách làm theo các bước sau:
- Mở dự án tập lệnh chứa tiện ích bổ sung của bạn.
- Nhấp vào Triển khai > Kiểm thử việc triển khai.
- Trong mục Kiểm thử đã lưu, hãy chọn nút chọn bên cạnh bản triển khai kiểm thử đã lưu mà bạn muốn chạy rồi nhấp vào Thực thi.
Tài liệu kiểm thử sẽ mở ra trong một thẻ mới. Tiện ích bổ sung ở trạng thái uỷ quyền được chỉ định trong quá trình triển khai thử nghiệm. Bạn có thể xác minh rằng tiện ích bổ sung hoạt động như dự kiến bằng cách tương tác với trình đơn và các phần tử trên giao diện người dùng của tiện ích bổ sung.
Để kiểm thử tính năng OAuth chi tiết trên tiện ích bổ sung, hãy đảm bảo rằng dự án của bạn chưa có các uỷ quyền. Để huỷ mọi uỷ quyền hiện có, hãy sử dụng ScriptApp.invalidateAuth.
Thông tin chi tiết về kiểm thử
Có một số điều cần lưu ý khi kiểm thử tiện ích bổ sung của Editor theo cách này:
- Trình kích hoạt có thể cài đặt không được hỗ trợ khi kiểm thử. Bạn không thể kiểm thử chức năng phụ thuộc vào các sự kiện kích hoạt có thể cài đặt.
- Trong khi chạy một bản triển khai thử nghiệm được thiết lập để kiểm thử bằng mã mới nhất, bạn có thể thấy những thay đổi được lưu vào tập lệnh tiện ích bổ sung bằng cách làm mới tài liệu thử nghiệm.
- Tài liệu kiểm thử có một URL mà bạn có thể chia sẻ với người chỉnh sửa tài liệu kiểm thử gốc. Nhờ đó, bạn có thể dễ dàng cộng tác với những người khác trong khi kiểm thử và phát triển.
- Nếu tiện ích bổ sung của bạn sử dụng dịch vụ Thuộc tính, thì các thuộc tính sẽ duy trì và vẫn có sẵn vào lần tiếp theo chạy quy trình triển khai kiểm thử.
- Ngoài ra, mọi hoạt động triển khai kiểm thử sử dụng cùng một tổ hợp tiện ích bổ sung và tài liệu kiểm thử đều có quyền truy cập vào cùng một thông tin về tài sản. Ví dụ: nếu bạn tạo 2 bản triển khai kiểm thử, thì các thuộc tính được lưu trong khi chạy bản triển khai đầu tiên sẽ có sẵn trong khi chạy bản triển khai thứ hai và ngược lại, nhưng chỉ khi các bản triển khai sử dụng cùng một tập lệnh và tài liệu kiểm thử.
- Nếu chạy một bản triển khai thử nghiệm, bạn có thể được nhắc uỷ quyền nếu chưa chạy tập lệnh trước đó. Xin lưu ý rằng việc uỷ quyền cho một tập lệnh trong khi kiểm thử cũng sẽ uỷ quyền cho tập lệnh đó bên ngoài quá trình kiểm thử.