Phát hành cục bộ

Ngoài chế độ phát hành có quản lý (Trực tuyến), Project Releaser còn hỗ trợ phát hành cục bộ, không được quản lý (Ngoại tuyến). Thông thường, chế độ phát hành này được sử dụng khi bạn không dùng Workspace hoặc hiện không thể kết nối với Workspace của mình. Mặc dù Project Releaser sẽ tự động xác định chế độ khi có thể, hoặc đưa ra các tùy chọn khi không thể xác định rõ ràng, bạn luôn có thể buộc sử dụng chế độ Ngoại tuyến. Để thực hiện việc này, hãy đặt Release Target trên thẻ Release Options của hộp thoại Project Release Options (nhấp vào nút khi đang ở Giai đoạn 1 của quy trình phát hành) thành một trong các tùy chọn sau:

• Unmanaged - Folder: chọn tùy chọn này để phát hành dữ liệu đã tạo vào một thư mục cục bộ. Đường dẫn thư mục gốc được chỉ định trên thẻ Output Path của hộp thoại. Theo mặc định, đường dẫn này được đặt thành [OutputPath] (sử dụng đường dẫn được xác định trong trường Output Path trên thẻ Options của hộp thoại Project Options).

• Unmanaged - Zip: chọn tùy chọn này để phát hành dữ liệu đã tạo vào một thư mục cục bộ. Dữ liệu sẽ được đóng gói vào một tệp Zip duy nhất. Đường dẫn/tên tệp Zip được chỉ định trên thẻ Output Path của hộp thoại. Theo mặc định, giá trị này được đặt thành [OutputPath][ProjectName].zip (sử dụng đường dẫn được xác định trong trường Output Path trên thẻ Options của hộp thoại Project Options).

Bạn có thể nhanh chóng nhận biết Project Releaser có được cấu hình ở chế độ Ngoại tuyến hay không qua các dấu hiệu sau:

• Tiêu đề của Giai đoạn 1 là Configure Local Release, thay vì Configure Server Release (khi ở chế độ Trực tuyến).

• Tiêu đề của Giai đoạn 5 là Pack Data, thay vì Upload Data (khi ở chế độ Trực tuyến).

Project Releaser được cấu hình ở chế độ cục bộ, không được quản lý (Ngoại tuyến).

Quy trình phát hành rất giống với quy trình được mô tả cho chế độ phát hành có quản lý (Trực tuyến), chỉ khác là dữ liệu được phát hành vào các thư mục cục bộ. Thay vì lặp lại thông tin đã mô tả trước đó, dưới đây là phần tóm tắt các giai đoạn, trong đó nêu bật những điểm khác biệt.

Giai đoạn Ngoại tuyến 1 – Cấu hình phát hành cục bộ

Đây là nơi bạn cấu hình dữ liệu muốn tạo từ dự án thiết kế của mình. Một bản phát hành luôn bao gồm dữ liệu nguồn và cũng có thể bao gồm dữ liệu chế tạo, lắp ráp (cơ sở và/hoặc các biến thể), cũng như mọi dữ liệu tùy chỉnh theo yêu cầu.

Với mỗi tập dữ liệu cần tạo, bạn phải chỉ định một thư mục đích để lưu dữ liệu đó. Các tên thư mục mặc định được sử dụng như sau:

• Source Data – sẽ được tạo trong thư mục Sources.

• Fabrication Data (chỉ dành cho dự án PCB) – sẽ được tạo trong thư mục Fabrication.

• Assembly Data for no variant – sẽ được tạo trong thư mục Assembly.

• Assembly Data for <VariantName> (chỉ dành cho dự án PCB) – sẽ được tạo trong thư mục Assembly <VariantName>.

• Custom Data <Custom - n> – sẽ được tạo trong thư mục <Custom - n>.

Tất nhiên, bạn có thể thay đổi cách đặt tên mặc định này cho phù hợp với yêu cầu của mình. Để thực hiện, hãy nhấp vào một mục Target Folder hiện có, nhập tên mới mong muốn cho thư mục rồi nhấn Enter.

Sau khi cấu hình các tập dữ liệu cần tạo trong bản phát hành theo yêu cầu, hãy nhấp vào nút ở góc dưới bên phải của khung nhìn để tiếp tục.

Nút có hai trạng thái. Các trạng thái này hơi khác nhau giữa hai tùy chọn phát hành không được quản lý:

• Unmanaged - Folder: nhấp vào nút này sẽ khởi chạy lệnh Prepare tiêu chuẩn. Lệnh này sẽ thực hiện quy trình phát hành đến giai đoạn Review Data – cho phép bạn kiểm tra lại để đảm bảo mọi thứ đều ổn trước khi phát hành vào các thư mục đích. Nếu không muốn tạm dừng để xem xét, hãy sử dụng menu thả xuống gắn với nút và chọn lệnh Prepare & Explore.
• Unmanaged - Zip: nhấp vào nút này sẽ khởi chạy lệnh Prepare tiêu chuẩn. Lệnh này sẽ thực hiện quy trình phát hành đến giai đoạn Review Data – cho phép bạn kiểm tra lại để đảm bảo mọi thứ đều ổn trước khi đóng gói dữ liệu vào tệp Zip. Nếu không muốn tạm dừng để xem xét, hãy sử dụng menu thả xuống gắn với nút và chọn lệnh Prepare & Pack.

Lúc này, một số bước kiểm tra trước khi phát hành sẽ được thực hiện, bao gồm:

• Đảm bảo dự án và tất cả các tệp đã được lưu.

• Đảm bảo dự án và tất cả các tệp liên quan đã được commit vào VCS, nếu áp dụng.

• Đảm bảo mỗi mục dữ liệu được bật đều đã được chỉ định thư mục đích.

Nếu phát hiện bất kỳ vấn đề nào, bạn sẽ được cung cấp các giải pháp để xử lý (chẳng hạn như lưu các tệp đã sửa đổi cục bộ và commit vào VCS).

Source Data được tạo ở giai đoạn này – với một bản chụp trạng thái các tệp nguồn của dự án thiết kế được phát hành vào thư mục đích.

Giai đoạn Ngoại tuyến 2 – Kiểm tra tính hợp lệ của dự án

Sau khi Giai đoạn 1 hoàn tất mà không có vấn đề, giai đoạn tiếp theo này của quy trình phát hành sẽ tự động chạy khi phát hiện một hoặc nhiều báo cáo loại Validation trong các tệp OutJob đã được chỉ định. Tất cả các bộ tạo đầu ra kiểm tra tính hợp lệ được định nghĩa trong tệp Output Job đã chỉ định cho mục dữ liệu đang phát hành đều được chạy. Giai đoạn này diễn ra giống như khi phát hành ở chế độ có quản lý (Trực tuyến).

Nhấp vào ở góc dưới bên phải của khung nhìn sẽ dừng quy trình phát hành.

Giai đoạn Ngoại tuyến 3 – Tạo dữ liệu

Sau khi Giai đoạn 2 hoàn tất mà không có vấn đề, giai đoạn tiếp theo này của quy trình phát hành sẽ tự động chạy. Đây là lúc tất cả các đầu ra khác – được định nghĩa trong các tệp OutJob đã chỉ định cho những mục dữ liệu có trong bản phát hành – được thực thi để tạo dữ liệu cần phát hành vào các thư mục đích tương ứng. Giai đoạn này diễn ra giống như khi phát hành ở chế độ có quản lý (Trực tuyến).

Nhấp vào ở góc dưới bên phải của khung nhìn sẽ dừng quy trình phát hành.

Giai đoạn Ngoại tuyến 4 – Xem xét dữ liệu

Khi tất cả các bước kiểm tra tính hợp lệ đều đạt và dữ liệu đầu ra đã được tạo, giai đoạn này của quy trình phát hành cho phép bạn xem xét dữ liệu đã tạo. Giai đoạn này hoạt động gần giống như khi phát hành ở chế độ có quản lý (Trực tuyến).

Kiểm tra dữ liệu đã tạo, bảo đảm mọi thứ đều đúng yêu cầu trước khi xác nhận phát hành và gửi dữ liệu đến các thư mục đích hoặc đóng gói dữ liệu vào tệp zip cục bộ, theo tùy chọn phát hành không được quản lý đã chọn.

Trong chế độ xem thu gọn của dữ liệu đã tạo, nhấp vào liên kết View để mở tệp dữ liệu hoặc bộ tệp tương ứng trong trình biên tập phù hợp của Altium Designer (ví dụ: trình biên tập CAM cho các tệp Gerber hoặc tệp ODB++ đã nén/chưa nén), hoặc trong ứng dụng bên ngoài phù hợp (ví dụ: Microsoft Excel cho bảng kê vật tư). Trong chế độ xem chi tiết, nhấp đúp vào một mục để chỉ xem tệp đó.

Nếu sau khi kiểm tra dữ liệu, bạn thấy cần chỉnh sửa, hãy nhấp vào nút ở góc dưới bên phải của chế độ xem. Một hộp thoại xác nhận sẽ xuất hiện, cảnh báo rằng toàn bộ dữ liệu đã tạo sẽ bị mất. Nhấp vào OK để hủy phát hành; bạn sẽ được đưa trở lại Giai đoạn 1 của quy trình.

Nếu toàn bộ dữ liệu đã tạo đều đạt yêu cầu, hãy tiếp tục phát hành bằng cách nhấp vào nút (cũng ở góc dưới bên phải của chế độ xem). Diễn biến tiếp theo phụ thuộc vào tùy chọn đích phát hành bạn đang sử dụng:

• Unmanaged - Folder: các tệp đã tạo sẽ được phát hành vào các thư mục đích và quy trình sẽ chuyển thẳng đến giai đoạn cuối cùng để xem Báo cáo thực thi.

• Unmanaged - Zip: quy trình sẽ chuyển sang giai đoạn tiếp theo – Pack Data.

Giai đoạn ngoại tuyến 5 – Đóng gói dữ liệu

Sau khi bạn xác nhận phát hành ở giai đoạn trước, quy trình sẽ tự động chuyển sang giai đoạn này, trong đó dữ liệu được đóng gói vào một tệp zip cục bộ duy nhất. Đường dẫn/tên tệp Zip được chỉ định trên thẻ Output Path của hộp thoại Project Release Options. Theo mặc định, giá trị này được đặt thành [OutputPath][ProjectName].zip (sử dụng đường dẫn được xác định trong trường Output Path trên thẻ Options của hộp thoại Project Options).

Giai đoạn ngoại tuyến 6 – Báo cáo thực thi

Đây là giai đoạn cuối cùng của quy trình, cung cấp thông tin tóm tắt về lần phát hành.

Báo cáo cuối cùng của lần phát hành, như được hiển thị khi sử dụng đích phát hành Unmanaged - Folder. Di chuột lên hình ảnh để xem báo cáo tương ứng khi đích phát hành được đặt thành Unmanaged - Zip.

Sử dụng liên kết điều hướng được cung cấp để truy cập nhanh (trong Windows File Explorer) đến thư mục đầu ra hoặc tệp zip đã đóng gói tương ứng.

Truy cập nhanh thư mục đầu ra chứa dữ liệu được phát hành cục bộ, ngay từ giai đoạn Báo cáo thực thi của giao diện. Di chuột lên hình ảnh để xem ví dụ về cách truy cập tệp zip đóng gói dữ liệu được phát hành cục bộ.