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

Sơ lược

Khám phá các công cụ và thiết lập dành cho việc viết tập lệnh trong Altium Designer, từ trình soạn thảo và trình gỡ lỗi đến các đơn vị mã tập lệnh, biểu mẫu và dự án mẫu. Bài viết này giới thiệu môi trường viết tập lệnh, giải thích cách chạy một ví dụ đơn giản và trình bày các tùy chọn để cấu hình không gian thiết kế của bạn. Hãy đọc tiếp để bắt đầu những bước đầu tiên trong việc tự động hóa tác vụ trong Altium Designer.

- Hiểu vai trò của các đơn vị mã tập lệnh, biểu mẫu tập lệnh và các bảng điều khiển dùng để viết và gỡ lỗi tập lệnh.
- Tìm hiểu cách mở và chạy tập lệnh mẫu, bao gồm dự án “Hello World”.
- Khám phá các thiết lập về hoạt động của trình soạn thảo, màu cú pháp, tùy chọn hiển thị, dự án tập lệnh toàn cục và thiết kế biểu mẫu.
Tìm hiểu sâu hơn với AI:
 

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

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

Altium Designer hiển thị các cửa sổ Mã tập lệnh và Biểu mẫu cùng với các bảng Object Inspector, Code Explorer và Tool Palette .
Altium Designer hiển thị các cửa sổ Mã tập lệnh và Biểu mẫu 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 tập lệnh

Hệ thống tập lệnh 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 – Có thể lưu tập lệnh trong dự án tập lệnh hoặc dự án thiết kế. Các tập lệnh trong cùng một dự án có thể truy cập các thủ tục từ bất kỳ tập lệnh nào thuộc dự án đó.

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

  • Scripting Panels – Hệ thống tập lệnh có một số bảng điều khiển giúp bạn viết mã và gỡ lỗi tập lệnh nhanh chóng.

  • Scripting Debugger – Nếu tập lệnh gặp lỗi trong khi thực thi, một hộp thoại sẽ xuất hiện kèm thông báo lỗi ngắn gọn. Bạn có thể xem trước các biến trong cửa sổ Watches, theo dõi mã và điều khiển việc thực thi tập lệnh bằng Trình gỡ lỗi tập lệnh.

  • Scripting Languages – Có thể tạo tập lệnh bằng DelphiScript và VBScript nếu ngôn ngữ này được bật dưới dạng ngôn ngữ cũ.

  • Ngôn ngữ tập lệnh mặc định được đặt là DelphiScript. Bạn có thể mở và chạy các tập lệnh hiện có được viết bằng VBScript và JavaScript (Jscript). Để có thể tạo tập lệnh mới bằng VBScript, bạn phải bật tùy chọn Legacy.Scripts.SupportOldLanguages trong hộp thoại Cài đặt nâng cao.

  • Bạn có thể tìm tài liệu về API tập lệnh tại đây: Các đối tượng API tập lệnh. Xin lưu ý rằng tài liệu này được cập nhật lần cuối cho một phiên bản Altium Designer cũ. Mặc dù nhiều nguyên tắc và cách tiếp cận vẫn giữ nguyên, hãy lưu ý rằng các giao diện, đối tượng, phương thức, thuộc tính và những thành phần tương tự đã thay đổi kể từ đó, nên tài liệu này không phản ánh đầy đủ các thành phần có trong những phiên bản phần mềm mới hơn.

Đơn vị mã và biểu mẫu tập lệnh

Dự án tập lệnh hỗ trợ hai loại tài liệu tập lệnh – Đơn vị mã tập lệnh và Biểu mẫu tập lệnh. Đơn vị mã tập lệnh cho phép bạn viết các thủ tục và hàm độc lập. Biểu mẫu tập lệnh cho phép bạn xây dựng các hộp thoại có điều khiển và trình xử lý sự kiện, cũng như các thủ tục và hàm.

  • Đơn vị mã tập lệnh 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 với các đối tượng thiết kế trên tài liệu thiết kế. Biểu mẫu tập lệnh chứa các điều khiển làm giao diện người dùng và tận dụng API X2 để cung cấp các hộp thoại tập lệnh thao tác trên tài liệu thiết kế đang hoạt động.
  • Biểu mẫu tập lệnh là một đơn vị biểu mẫu trực quan được tập lệnh hỗ trợ. Khi hoạt động, biểu mẫu thể hiện dưới dạng một cửa sổ hộp thoại.
  • Biểu mẫu tập lệnh có hai chế độ xem – Mã tập lệnh và Biểu mẫu tập lệnh. Chế độ xem Mã tập lệnh chứa các trình xử lý sự kiện và thủ tục/hàm. Chế độ xem Biểu mẫu tập lệnh thể hiện một biểu mẫu hộp thoại (thuộc các loại khác nhau), chứa các điều khiển cùng với trình xử lý sự kiện tương ứng.
  • Biểu mẫu tập lệnh có hai tệp liên quan. Một tệp *.pas chứa các trình xử lý sự kiện và thủ tục/hàm, còn một tệp *.dfm chứa thông tin chi tiết về chính biểu mẫu tập lệnh cùng với các thành phần và vị trí của chúng.
  • Thành phần là một đối tượng điều khiển trực quan hoặc phi trực quan (được đặt từ bảng Bảng công cụ), tiếp nhận thông tin đầu vào từ người dùng, chẳng hạn như thao tác nhấp chuột hoặc một chuỗi ký tự được nhập. Trong quá trình thiết kế, bạn có thể sử dụng bảng Trình kiểm tra đối tượng để thao tác với các thành phần trên Biểu mẫu tập lệnh. Các thành phần có thể được sử dụng trong bất kỳ Biểu mẫu tập lệnh nào, với bất kỳ bộ ngôn ngữ nào mà hệ thống tập lệnh hỗ trợ.
  • Một thành phần (đối tượng điều khiển) có các phương thức, thuộc tính và sự kiện mà Biểu mẫu tập lệnh có thể sử dụng.
    • Phương thức là những hành động mà một đối tượng có thể thực hiện.
    • Thuộc tính thể hiện dữ liệu chứa trong đối tượng mà bạn có thể truy cập hoặc sửa đổi.
    • Sự kiện là những điều kiện mà một thành phần trên Biểu mẫu tập lệnh có thể phản hồi.
  • Biểu mẫu tập lệnh có các trình xử lý sự kiện để xử lý những điều kiện được ghi nhận, chẳng hạn như khi nhấp vào một nút trên biểu mẫu.

Tài liệu về tập lệnh chủ yếu tập trung vào bộ ngôn ngữ DelphiScript. Bộ ngôn ngữ DelphiScript dựa trên công nghệ DelphiScript của Embarcadero. Để biết thông tin về sự khác biệt giữa DelphiScript và Object Pascal (được sử dụng trong Delphi), hãy tham khảo tài liệu tham chiếu DelphiScript.

Ví dụ về tập lệnh trong Altium Designer

Các tập lệnh ví dụ và tham chiếu là nguồn tài nguyên hữu ích để tìm hiểu cách áp dụng giao diện đối tượng, phương thức, quy trình, thuộc tính và thành phần trong tập lệnh. Bạn cũng có thể dùng chúng làm cơ sở cho các dự án tập lệnh của riêng mình.

Bạn có thể tải xuống các thiết kế tham chiếu cũ, được xây dựng vào thời điểm ra mắt Altium Designer 10, tại đây. Chúng bao gồm một số ví dụ về mô phỏng và tập lệnh. Hãy lưu ý rằng đây là các thiết kế cũ và không được cập nhật.
Để biết thông tin về các ví dụ tập lệnh khác, hãy tham khảo Tài liệu tham chiếu ví dụ tập lệnh. Để được hướng dẫn thực hành về các ví dụ tập lệnh hoạt động trong Altium Designer, hãy tham khảo Viết tập lệnh và Phân tích ví dụ tập lệnh.

Chạy một ví dụ

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

Các ví dụ tập lệnh có trong thư mục giải nén từ tệp zip đã tải xuống.

Dự án DelphiScript Hello World được mở trong bảng Projects .
Dự án DelphiScript Hello World được mở trong bảng Projects .

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

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

Cách nhanh chóng và đơn giản để chạy một tập lệnh ví dụ.Cách nhanh chóng và đơn giản để chạy một tập lệnh ví dụ.

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

Tùy chọn

Bạn có thể cấu hình các thiết lập tùy chọn mặc định cho hệ thống tập lệnh trong hộp thoại Tùy chọn, đượ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 không gian thiết kế.

Tùy chọn chung

Trang Trình soạn thảo văn bản – Chung của hộp thoại Preferences cho phép bạn thiết lập các yêu cầu soạn thảo tập lệnh, chẳng hạn như cách tìm kiếm chuỗi, cách đặt tab và thụt lề dòng, cách gán phím cùng một số 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 Trình soạn thảo văn bản – Màu sắc của hộp thoại Preferences cho phép bạn cấu hình màu cú pháp trong Trình soạn thảo tập lệnh cho ngôn ngữ lập trình tập lệnh 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. Ví dụ: màu đen cho nền, màu trắng cho các từ khóa chú thích, v.v.

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

Tùy chọn hiển thị

Trang Trình soạn thảo văn bản – Hiển thị của hộp thoại Preferences cho phép bạn cấu hình các đặc điểm hiển thị của tập lệnh, 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ở rộng các khối mã.

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

Tùy chọn dự án toàn cục

Trang Hệ thống lập trình tập lệnh – Dự án toàn cục của hộp thoại Preferences liệt kê các dự án tập lệnh hiện có (đã cài đặt). Bạn có thể cài đặt, gỡ bỏ hoặc sắp xếp lại thứ tự các dự án tập lệnh.

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

Tùy chọn trình thiết kế biểu mẫu

Trang Hệ thống lập trình tập lệnh – Trình thiết kế biểu mẫu của hộp thoại Preferences cung cấp các tùy chọn về lưới và ký hiệu định danh thành phần cho tài liệu biểu mẫu tập lệnh.

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

AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Nav
Contents
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Tài liệu cũ

Tài liệu Altium Designer không còn được phân phiên bản. Nếu bạn cần truy cập tài liệu cho các phiên bản cũ hơn của Altium Designer, hãy truy cập mục Tài liệu cũ trên trang Trình cài đặt khác.

Contents