Tổng quan & Thiết lập Hệ thống Scripting

Hệ thống script của Altium Designer cung cấp đầy đủ công cụ và tính năng cần thiết để tạo các script tự động hóa tác vụ trong phần mềm.

Trình soạn thảo script, trình gỡ lỗi và các bảng điều khiển scripting phối hợp với nhau để giúp bạn dễ dàng viết và gỡ lỗi script. Script có thể được chạy trực tiếp từ trình soạn thảo script hoặc được gán vào menu, thanh công cụ hay phím nóng để có thể áp dụng cho tài liệu hiện tại – chẳng hạn như PCB Layout – bất kỳ lúc nào.

Altium Designer hiển thị các cửa sổ Script Code và Form cùng với các bảng Object Inspector, Code Explorer và Tool Palette .

Các tính năng của hệ thống scripting

Hệ thống scripting gồm hai phần chính – trình soạn thảo và trình gỡ lỗi. Các tính năng chính như sau:

• Project access – Script có thể được lưu trong một script project hoặc design project. Các routine từ bất kỳ script nào trong một project đều có thể được truy cập bởi các script khác trong cùng project.

• Scripting Editor – Trình soạn thảo scripting có trình biên tập văn bản chuyên dụng với nhiều tùy chọn để thiết lập môi trường chỉnh sửa và tô màu cú pháp.

• Scripting Panels – Hệ thống scripting có nhiều panel hỗ trợ bạn lập trình và gỡ lỗi script nhanh chóng.

• Scripting Debugger – Nếu script có lỗi khi đang thực thi, một hộp thoại sẽ xuất hiện với thông báo lỗi ngắn gọn. Bạn có thể xem trước biến trong cửa sổ Watches, lần vết mã và điều khiển việc thực thi script bằng Script Debugger.

• Scripting Languages – Script có thể được tạo bằng DelphiScript và, nếu được bật như một ngôn ngữ legacy, VBScript.

Script Units và Forms

Script Projects hỗ trợ hai loại tài liệu script – Script Units và Script Forms. Script Units cho phép bạn viết các procedure và function độc lập. Script Forms cho phép bạn xây dựng các hộp thoại với control và event handler, cũng như các procedure và function.

• Script Unit có thể sử dụng Giao diện Lập trình Ứng dụng (API) X2 để sửa đổi hoặc thao tác các đối tượng thiết kế trên một tài liệu thiết kế. Script Form chứa các control như một giao diện người dùng và tận dụng X2 API để cung cấp các hộp thoại script tác động lên tài liệu thiết kế đang hoạt động.
• Script Form là một form trực quan được script hỗ trợ. Khi form đang hoạt động, nó đại diện cho một cửa sổ hộp thoại.
• Script Form có hai chế độ xem – Script Code view và Script Form view. Script Code view chứa các event handler và procedure/function. Script Form view biểu diễn một form hộp thoại (thuộc nhiều loại khác nhau) và có các control cùng với các event handler tương ứng của chúng.
• Script Form có hai tệp liên quan. Một tệp *.pas chứa các event handler và procedure/function, và một tệp *.dfm chứa thông tin chi tiết về chính script form cùng với các thành phần của nó và vị trí của chúng.
• Một component là một đối tượng control trực quan hoặc không trực quan (được đặt từ panel Tool Palette panel) nhận đầu vào từ người dùng, chẳng hạn như cú nhấp chuột hoặc một chuỗi ký tự được nhập. Trong quá trình thiết kế, panel Object Inspector panel có thể được dùng để thao tác các component trên một Script Form. Các component này có thể được dùng trong bất kỳ Script Form nào với bất kỳ bộ ngôn ngữ nào được hệ thống Scripting hỗ trợ.
• Một component (đối tượng control) có method, property và event có thể được Script Form sử dụng.
  • Method là các hành động mà một đối tượng có thể thực hiện.
  • Property biểu thị dữ liệu chứa trong đối tượng mà có thể được truy cập hoặc chỉnh sửa.
  • Event là các điều kiện mà một component trên Script Form có thể phản ứng lại.
• Script Form có các event handler để xử lý các điều kiện được bắt, chẳng hạn như khi một nút trên form được nhấp.

Ví dụ về Script trong Altium Designer

Các script ví dụ và tham chiếu là nguồn tài nguyên hữu ích để hiểu cách các interface đối tượng, method, process, property và component được áp dụng trong script. Chúng cũng có thể được dùng làm nền tảng cho các script project của riêng bạn.

Chạy một ví dụ

Để nhanh chóng chạy một ví dụ script trong Altium Designer, trước tiên hãy mở một example project hoặc một tệp script riêng lẻ từ một trong các thư mục script mẫu – ví dụ như project 'Hello World' đơn giản (HelloWorld.PRJSCR) từ thư mục Scripts\Delphiscript Scripts\General.

Project DelphiScript Hello World được mở trong panel Projects .

Project này chứa hai phiên bản của script 'Hello World', trong đó phiên bản thứ hai (HelloWorlDialog.pas) minh họa cách sử dụng cơ bản của một Form unit. Nhấp đúp vào tên script để mở và kiểm tra script trong trình soạn thảo – lưu ý rằng script có thể được chạy mà không cần mở trong trình soạn thảo.

Để chạy một trong các script, hãy chọn File » Run Script từ menu chính, sau đó chọn một procedure script khả dụng từ hộp thoại Select Item To Run. Khi một phiên bản được chạy, một hộp thoại sẽ mở ra để hiển thị thông báo.

Cách nhanh và đơn giản để chạy một script ví dụ.

Thiết lập hệ thống scripting

Tùy chọn

Các thiết lập tùy chọn mặc định cho hệ thống scripting có thể được cấu hình trong hộp thoại Preferences, được truy cập bằng cách nhấp vào nút điều khiển ở góc trên bên phải của vùng thiết kế.

Tùy chọn chung

Trang Text Editors – General của hộp thoại Preferences cho phép bạn thiết lập các yêu cầu chỉnh sửa script, chẳng hạn như hành vi tìm kiếm chuỗi, cách các dòng được tab và thụt lề, cách ánh xạ phím và nhiều tùy chọn nâng cao khác.

Trang Text Editors – General của hộp thoại Preferences

Tùy chọn màu sắc

Trang Text Editors – Colors của hộp thoại Preferences cho phép bạn cấu hình tô màu cú pháp của Script Editor cho ngôn ngữ scripting mà bạn chọn, đồng thời thiết lập màu cho các thành phần trong trình soạn thảo script. Ví dụ: nền màu đen, từ khóa chú thích màu trắng, v.v.

Trang Text Editors – Colors của hộp thoại Preferences

Tùy chọn hiển thị

Trang Text Editors – Display của hộp thoại Preferences cho phép bạn cấu hình các tính năng hiển thị của script, chẳng hạn như hiển thị lề phải và số dòng, tô sáng cú pháp và thu gọn mã.

Trang Text Editors – Display của hộp thoại Preferences

Tùy chọn Global Projects

Trang Scripting System – Global Projects của hộp thoại Preferences liệt kê các script project hiện có sẵn (đã cài đặt). Script project có thể được cài đặt, gỡ bỏ hoặc sắp xếp lại thứ tự.

Trang Scripting System – Global Projects của hộp thoại Preferences

Tùy chọn Form Designer

Trang Scripting System – Form Designer của hộp thoại Preferences cung cấp các tùy chọn lưới và định danh component cho tài liệu scripting form.

Trang Scripting System – Form Designer của hộp thoại Preferences