Lịch sử phiên bản flow

Xem lịch sử phiên bản của một flow và xem chi tiết từng phiên bản. Khi bạn khám phá các phiên bản trước, bản nháp hiện tại và phiên bản đang chạy trực tiếp vẫn không thay đổi. Khi sẵn sàng, hãy khôi phục phiên bản bạn muốn và xuất bản.

Để mở danh sách các phiên bản, trong thanh công cụ trên cùng của Flow & Paywall Builder, nhấn Version history. Danh sách sẽ thay thế bảng điều khiển bên phải. Để đóng lại, nhấn Version history thêm một lần nữa.

Nút Version history trong thanh công cụ trên cùng của builder, đang được nhấn, với bảng Version history mở bên dưới

Tìm phiên bản bạn cần

Nếu bạn chưa xuất bản flow hiện tại, lịch sử phiên bản sẽ trống.

Ngược lại, các phiên bản đã xuất bản sẽ hiển thị theo thứ tự thời gian, phiên bản mới nhất ở trên cùng.

The Version history panel with a Draft version and a Live version

Danh sách sẽ làm nổi bật phiên bản đang được mở. Đọc nhãn để xem trạng thái của từng phiên bản:

  • Draft: Phiên bản bạn đang chỉnh sửa.
  • Publishing…: Bản draft đang được xuất bản.
  • Publish failed: Bản draft xuất bản không thành công. Tìm và khắc phục nguyên nhân, sau đó xuất bản lại.
  • Live: Phiên bản người dùng đang thấy.
  • Không có nhãn: Phiên bản đã từng live trước đó.

Mỗi hàng phiên bản cũng hiển thị người đã lưu phiên bản đó lần cuối, trước ngày lưu: You là thay đổi của bạn, Adapty Team là thay đổi từ nhân viên Adapty, hoặc tên hay email của thành viên trong nhóm.

Để tìm một phiên bản cụ thể trong danh sách, hãy tìm kiếm theo tên. Khi bạn phát hành bản cập nhật lớn, hãy đặt tên mô tả cho phiên bản mới để có thể nhanh chóng tìm và khôi phục sau này. Để đổi tên một phiên bản, mở menu ngữ cảnh của mục đó và chọn Rename.

Xem phiên bản trước đó

Để xem trước một phiên bản, hãy nhấp vào hàng của nó. Phiên bản sẽ mở ở chế độ chỉ đọc: bạn có thể xem qua các màn hình và các phần tử, nhưng không thể thay đổi bất cứ điều gì.

The Version history panel with the v2 version highlighted

Để kiểm tra thuộc tính của phần tử, hãy đóng bảng Version history. Bản xem trước vẫn còn mở.

Để mở phiên bản trong ứng dụng di động Adapty, nhấp vào Test on device, sau đó quét mã QR hoặc mở đường liên kết.

Để quay lại bản nháp mới nhất, hãy nhấp vào Back to current version.

Khôi phục phiên bản trước đó

Tip

Khôi phục một phiên bản trong cùng một flow sẽ thay thế bản nháp hiện tại của bạn. Để giữ lại bản nháp, hãy nhân bản nó thành một flow mới trước khi khôi phục.

Bạn có thể khôi phục phiên bản flow trước đó theo một trong hai cách. Tìm mục phiên bản cần thiết, mở menu ngữ cảnh và chọn một trong các tùy chọn:

  • Duplicate as draft: Khôi phục phiên bản trong cùng một flow. Nếu flow đã có bản draft, hãy xác nhận bằng Replace draft. Phiên bản được khôi phục sẽ không được phát hành cho đến khi bạn xuất bản lại. Khả dụng cho phiên bản Live và các phiên bản đã từng live trước đó.
  • Duplicate as new flow: Khôi phục phiên bản dưới dạng một flow mới. Flow gốc không thay đổi và vẫn giữ bản draft mới nhất. Flow mới sẽ mở trong tab mới.
Menu ngữ cảnh của một mục phiên bản, với Duplicate as draft và Duplicate as new flow

Khôi phục một màn hình hoặc phần tử

Để khôi phục một màn hình hoặc phần tử đơn lẻ, hãy xem trước phiên bản cũ hơn, chọn phần tử bạn cần và sao chép bằng phím tắt (Cmd/Ctrl+C). Quay lại bản nháp mới nhất và dán vào đó. Nếu bản sao sử dụng thứ gì đó bạn đã xóa kể từ phiên bản đó — chẳng hạn như font hoặc kiểu văn bản — hãy thay thế các tham chiếu đó, nếu không bạn sẽ không thể xuất bản flow.

Làm việc với các phiên bản từ CLI hoặc trợ lý AI

Lịch sử phiên bản cũng có thể truy cập bên ngoài Flow & Paywall Builder: trong Adapty CLI, và với các trợ lý AI thông qua Adapty MCP server. Flow-generator skill sử dụng nó để khôi phục về một thay đổi trước đó. CLI và MCP server hoạt động với cùng lịch sử phiên bản như dashboard, vì vậy chúng hiển thị cùng các phiên bản và tên, đồng thời đưa ra cùng thông báo khi Adapty từ chối một hành động. Cả hai đều sử dụng Adapty Developer API, có các hành động lịch sử phiên bản giống nhau: list, view, rename, restore, và duplicate.

Each dashboard action has a CLI command and an MCP tool:

Trên dashboardLệnh CLICông cụ MCP
Danh sách phiên bản và tìm kiếmadapty flows versions list, với --searchflows_versions_list
Nhấp vào một hàng phiên bảnadapty flows versions getflows_versions_get
Test on deviceadapty flows versions previewflows_versions_preview
Renameadapty flows versions renameflows_versions_rename
Duplicate as draftadapty flows versions restoreflows_versions_restore
Duplicate as new flow, và Duplicate flow trong nút hành động flow ở thanh trênadapty flows duplicateflows_duplicate

Việc khôi phục sẽ thay thế bản nháp, tương tự như Duplicate as draft. Để giữ lại bản nháp, hãy nhân bản nó sang một flow mới trước. Khi flow có bản nháp, CLI và trợ lý sẽ hỏi bạn trước khi thay thế.

Để thay thế bản nháp, CLI và trợ lý sẽ gửi timestamp updated_at của bản nháp từ danh sách các phiên bản. Nếu một thành viên trong nhóm đã lưu bản nháp sau lần đọc đó, Adapty sẽ từ chối việc khôi phục với thông báo This flow configuration was already updated by …, và bản nháp của thành viên đó vẫn được giữ nguyên. Hãy liệt kê lại các phiên bản và thử lại.

For a flow that has never been published, the dashboard history is empty, but the CLI prints History will appear after the first publish. and the draft under it.

Hạn chế

Bạn không thể:

  • Khôi phục trạng thái trước đó của bản nháp. Để hoàn tác các chỉnh sửa gần đây, hãy dùng undo. Để hủy toàn bộ thay đổi kể từ khi phiên bản được xuất bản, hãy khôi phục phiên bản Live.
  • Đổi tên, khôi phục, hoặc nhân bản một phiên bản của flow đã được lưu trữ. Để thực hiện các thao tác này, hãy kích hoạt lại flow trước.

Khắc phục sự cố

Triệu chứngNguyên nhânCách khắc phục
Khi bạn xuất bản phiên bản đã khôi phục, hộp thoại Can’t publish yet xuất hiện.Phiên bản vừa khôi phục sử dụng một sản phẩm hoặc ưu đãi không còn tồn tại.Thay thế tham chiếu sản phẩm và khắc phục các sự cố hiện có khác.
Khi bạn khôi phục phiên bản cũ hơn, bạn thấy lỗi This flow configuration was already updated by ….Một đồng nghiệp đã thay đổi bản nháp sau khi bạn mở flow.Tải lại trang, sau đó khôi phục lại.