Gỡ lỗi tập lệnh

Sơ lược

Việc gỡ lỗi script trong Altium Designer bắt đầu từ việc hiểu lỗi xảy ra ở đâu và cách kiểm tra quá trình thực thi script. Bài viết này giới thiệu các công cụ để tạm dừng và theo dõi từng bước mã, kiểm tra giá trị biến và theo dõi các lời gọi thủ tục, cùng với cách xử lý ngoại lệ và hiển thị thông báo phản hồi cho người dùng. Hãy đọc tiếp để tự tin hơn trong việc tìm và khắc phục lỗi script.

- Tìm hiểu cách các điểm dừng, Step Into, Step Over và Run To Cursor giúp bạn kiểm tra hành vi của script.
- Khám phá cách các công cụ kiểm tra biến và bảng Call Stack cho biết những gì đang diễn ra trong quá trình thực thi.
- Hiểu cách các trình xử lý ngoại lệ và hộp thoại thông báo trong DelphiScript hỗ trợ xử lý lỗi và phản hồi cho người dùng.
Tìm hiểu sâu hơn với AI:
 

Hệ thống lập trình script của Altium Designer cung cấp một môi trường gỡ lỗi đầy đủ tính năng. Trình gỡ lỗi script giúp bạn xác định và khắc phục lỗi trong script bằng nhiều công cụ tự động và bảng thông tin.

Lỗi script

Các lỗi thường gặp bao gồm phương thức không hợp lệ, toán tử nhóm đặt sai vị trí, kiểu dữ liệu không khớp, lỗi logic và lỗi đánh máy. Khi hệ thống lập trình script gặp lỗi, trình gỡ lỗi sẽ tạm dừng script và hiển thị hộp thoại thông báo lỗi.

Ví dụ bên dưới minh họa một script bị thiếu ký tự kết thúc và thông báo tương ứng trong hộp thoại lỗi.

 Trình gỡ lỗi sẽ tạm dừng script khi có lỗi biên dịch hoặc lỗi thời gian chạy.

Sau khi đóng hộp thoại lỗi, bạn có thể sửa mã và chạy lại script. Nếu cần dừng script – chẳng hạn khi chạy từng bước – hãy sử dụng lệnh Stop (Run » Stop, Ctrl+F3) hoặc nút ( trên thanh công cụ Script Debug).

Trong một số trường hợp, lỗi có thể khiến script bị kẹt trong vòng lặp vô hạn và không phản hồi. Để khắc phục vấn đề này, hãy nhấn tổ hợp phím tắt Ctrl+Pause/Break để ngắt vòng lặp của script.

Gỡ lỗi script

Hệ thống lập trình script có nhiều công cụ hỗ trợ gỡ lỗi script. Các công cụ này bao gồm đặt nhiều điểm ngắt trong script, sử dụng bảng Watch List để theo dõi giá trị của biến, sử dụng dấu trang để di chuyển hiệu quả hơn và sử dụng các chức năng bước vào và bước qua để theo vết script.

Ví dụ: bạn có thể sử dụng các tính năng sau khi kiểm tra giá trị của biến và biểu thức trong script:

► Xem Công cụ của trình soạn thảo script để biết thông tin về cách sử dụng các công cụ soạn thảo khi gỡ lỗi script.

Nếu bạn đang gỡ lỗi một script thao tác trên tài liệu đang mở – chẳng hạn khi sử dụng giao diện IPCB_Board để lấy dữ liệu từ tài liệu PCB – trình soạn thảo script sẽ không thể nhận diện tài liệu đó là tài liệu đang hoạt động. Trong trường hợp này, hãy lưu mọi thay đổi đã thực hiện rồi chạy script từ chính tài liệu đang hoạt động (File » Run Script).

Theo vết

Để hỗ trợ tìm và khắc phục lỗi chưa xác định trong script, bạn có thể chèn một loạt điểm ngắt vào script để tạm dừng mã tại nhiều vị trí trong khi kiểm tra giá trị của các biến và biểu thức.

Tuy nhiên, bất cứ khi nào script đang tạm dừng, bạn cũng có thể cho script thực thi từng dòng mã bằng các tính năng theo vết/chạy từng bước của trình gỡ lỗi. Bằng cách này, bạn có thể sử dụng điểm ngắt để tạm dừng script ban đầu tại khu vực cần quan tâm, rồi thực thi từng dòng bằng tính năng theo vết. Quá trình thực thi script từng dòng được gọi là theo vết hoặc chạy script từng bước.

Trình gỡ lỗi script cung cấp các lệnh liên quan đến theo vết – bước vào (Run » Step Into) và bước qua (Run » Step Over). Nhờ đó, bạn có thể theo vết quá trình thực thi script và phân tích hành vi của script khi gỡ lỗi mã.

Các lệnh gỡ lỗi có trong menu Run .
Các lệnh gỡ lỗi có trong menu Run .

Lệnh Step Into

Quá trình Step Into thực thi script từng câu lệnh một. Bạn có thể sử dụng lệnh này từ menu Run , nút tương ứng trên thanh công cụ Script Debug () hoặc phím tắt F7 .

Nếu câu lệnh đang thực thi gọi một thủ tục khác, việc bước vào câu lệnh đó sẽ chuyển quyền điều khiển đến dòng đầu tiên trong thủ tục được gọi. Phần tô sáng màu xanh đậu trong trình soạn thảo cho biết dòng mã mà script đang thực thi đến. Quá trình chạy script từng bước được hủy bằng lệnh Run » Stop, phím tắt Ctrl+F3 hoặc nút trên thanh công cụ ().

Lệnh Step Over

Quá trình Step Over tương tự như Step Into, ngoại trừ việc nếu câu lệnh hiện tại gọi một thủ tục khác, toàn bộ thủ tục được gọi sẽ được thực thi liên tục mà không dừng lại, thay vì theo vết bên trong thủ tục đó. Bạn có thể sử dụng lệnh này từ menu Run , nút tương ứng () hoặc phím tắt F8 .

Lệnh này hữu ích khi đã xác định rằng thủ tục called không phải là nguyên nhân gây ra sự cố trong thủ tục hiện tại, giúp tránh phải theo vết từng dòng một cách không cần thiết trong thủ tục được gọi – thủ tục đó được “bước qua”.

Sử dụng lệnh Run » Run To Cursor từ các menu chính (phím tắt: Ctrl+F9) để thực thi script đến vị trí con trỏ. Script sẽ tạm dừng tại dòng đó như khi gặp điểm ngắt, và bạn có thể tiếp tục chạy hoặc chạy từng bước từ vị trí này.

Bảng Call Stack

Bảng Call Stack được dùng để xem chuỗi các thủ tục và hàm đã dẫn đến vị trí thực thi hiện tại trong script đang được gỡ lỗi.

Bảng Call Stack
Bảng Call Stack

Khi bạn gỡ lỗi script từng bước, bảng sẽ hiển thị tên của bất kỳ hàm hoặc thủ tục nào mà bạn bước vào.

Khi gặp lời gọi đến một hàm hoặc thủ tục khác, bảng sẽ hiển thị thêm tên của hàm/thủ tục đó khi bạn bước vào. Do hàm/thủ tục này được gọi từ bên trong một hàm/thủ tục khác, hàm/thủ tục ban đầu vẫn được hiển thị trong bảng.

Một “ngăn xếp lời gọi” được hình thành, thể hiện mối quan hệ giữa các lời gọi hàm/thủ tục lồng nhau. Hàm/thủ tục ban đầu xuất hiện ở đáy ngăn xếp, mỗi hàm/thủ tục được gọi tiếp theo nằm phía trên, cho đến hàm/thủ tục hiện đang được truy cập ở đỉnh ngăn xếp.

Khi quá trình thực thi script thoát khỏi một hàm/thủ tục con và quay lại hàm/thủ tục gọi nó, hàm/thủ tục con sẽ bị loại khỏi ngăn xếp và hàm/thủ tục gọi nó sẽ trở thành phần tử ở đỉnh ngăn xếp.

Nhấp đúp vào một mục trong bảng sẽ chuyển đến dòng script tương ứng, nơi thực hiện lời gọi đến hàm hoặc thủ tục đã chọn. Dòng đó sẽ được tô sáng bằng màu dành cho lỗi script và có dấu báo lỗi script hiển thị ở lề phải. Cách hiển thị này chỉ nhằm mục đích đánh dấu. Dấu đánh dấu sẽ biến mất khi bạn nhấp vào tài liệu và hoàn toàn không cản trở phiên gỡ lỗi.

Ngoại lệ và thông báo

Như thường thấy trong mọi dự án lập trình, việc phát triển và gỡ lỗi mã script không nhất thiết kết thúc khi script đã “chạy được”. Khi sử dụng thực tế, script có thể gặp những lỗi không lường trước hoặc không mang lại kết quả mong đợi.

May mắn thay, bạn có thể sử dụng hệ thống lập trình script theo nhiều cách để xử lý các ngoại lệ khi thực thi và cung cấp phản hồi cho người dùng về hoạt động của script.

Trình xử lý ngoại lệ

Trong DelphiScript, từ khóa try mở đầu một câu lệnh try-except hoặc một câu lệnh try-finally. Hai câu lệnh này có liên quan nhưng phục vụ các mục đích khác nhau.

Try Finally

Trong trình xử lý Try-Finally, các câu lệnh trong khối finally luôn được thực thi – bất kể có xảy ra ngoại lệ trong khối try hay không. Sử dụng khối try-finally để giải phóng các đối tượng tạm thời hoặc tài nguyên khác và thực hiện các thao tác dọn dẹp.

Reset(F);
Try
  // process file F
Finally
  CloseFile(F);
End;

Try Except

Sử dụng câu lệnh Try-Except để bắt các ngoại lệ được phát sinh và thực thi mã xử lý lỗi tương ứng. Ví dụ, có thể bắt một ngoại lệ cụ thể rồi cập nhật nhật ký hoặc mở hộp thoại mô tả lỗi. Một ngoại lệ trong mã ở khối try sẽ khiến khối except được thực thi.

Trong ví dụ bên dưới, thủ tục ApplyOffset được gọi từ thủ tục DefineOffset với các tham số phù hợp. Thủ tục này thực hiện một phép chia đơn giản (trên các biến Ydim và Zdim ) rồi hiển thị kết quả (Offset) trong một hộp thoại tiêu chuẩn.

Procedure ApplyOffset(Ydim, Zdim);
Var
   Offset;
Begin;
   Try
      Offset := Ydim div Zdim;
      ShowInfo('Calculated Offset = ' + IntToStr(Offset));
   Except
      ShowWarning('Entered Z dimension must be greater than zero.');
   End;
End;

Procedure DefineOffset;
Begin;
   ApplyOffset(32, 4);
End;

Với các tham số ApplyOffset được trình bày ở trên (32,4), tập lệnh khi thực thi sẽ hiển thị kết quả tính toán bằng thủ tục ShowMessage, như minh họa bên dưới.

Ngoài ra, việc thay đổi các tham số được truyền thành 32,0 (ApplyOffset(32, 0);) sẽ gây ra ngoại lệ chia cho 0 trong phép tính Offset, kích hoạt khối xử lý Except. Khối này sử dụng thủ tục ShowWarning để hiển thị hộp thoại Warning tương ứng.

Trong chế độ gỡ lỗi của trình soạn thảo tập lệnh, một ngoại lệ sẽ khiến việc thực thi tập lệnh tạm dừng khi hộp thoại Error được đóng. Sử dụng lệnh Run hoặc Step Into để tiếp tục.

Raise

Thủ tục xử lý lỗi đơn giản ở trên giả định rằng ngoại lệ phát sinh do lỗi chia cho 0, nhưng điều này có nghĩa là nội dung hộp thoại cảnh báo sẽ không mô tả chính xác các loại ngoại lệ khác. Tuy nhiên, trong ví dụ này, đây là ngoại lệ có khả năng xảy ra cao nhất.

Tuy vậy, từ góc độ người dùng, vẫn nên có một hình thức phát hiện lỗi cụ thể. Trong DelphiScript, từ khóa On của Delphi (để bắt một loại ngoại lệ được chỉ định) không được hỗ trợ, nhưng có thể sử dụng câu lệnh Raise bên trong khối Except để phát sinh lại ngoại lệ gần nhất (bất kể đó là loại nào).

Try
   Offset := Ydim div Zdim;
   ShowInfo('Calculated Offset = ' + IntToStr(Offset));
Except
   Raise;
End;

Theo cách này, khi phần lớn mã của một thủ tục nằm trong khối try của câu lệnh try-except, mọi ngoại lệ đều có thể được báo cáo bằng câu lệnh Raise . Lưu ý rằng hộp thoại ngoại lệ sẽ chỉ hiển thị các thông báo lỗi chung, thay vì thông tin cụ thể về tập lệnh.

   

Có thể sử dụng Raise không kèm tham số để phát sinh lại ngoại lệ gần nhất, hoặc kèm một tham số chuỗi để đưa ra thông báo lỗi cụ thể.

Raise cũng có thể được sử dụng để chủ động phát sinh ngoại lệ dựa trên các phép kiểm tra cụ thể, chẳng hạn bằng cách áp dụng các câu lệnh if-then hoặc case đơn giản.

Procedure ApplyOffset(Ydim, Zdim);
Var
   Offset;
Begin;
   if Zdim > Ydim then
      Begin;
         Raise('Z dimension must be smaller than Y dimension.');
      End;
   Offset := Ydim div Zdim;
   ShowInfo('Calculated Offset = ' + IntToStr(Offset));
End;

Ở đây, nếu tham số Zdim trong ví dụ trên lớn hơn tham số Ydim, một ngoại lệ (kèm thông báo) sẽ được phát sinh.

Lỗi trong tập lệnh VB

Bản triển khai VBScript trong bộ máy thực thi tập lệnh của Altium Designer có các hàm tích hợp sẵn có thể được sử dụng trong các dự án tập lệnh VBScript, chẳng hạn như hàm MsgBox .

Có thể sử dụng câu lệnh On Error để bắt lỗi trong tập lệnh VB. Tham khảo tài liệu Microsoft VBScript để biết thêm thông tin về cách bắt lỗi.

Thông báo

Nhìn chung, thông báo là phương thức chính để cải thiện hoạt động của tập lệnh từ góc độ người dùng.

Thông báo có thể đưa ra cảnh báo về ngoại lệ hoặc cung cấp thông tin và cảnh báo trong quá trình chạy, đồng thời có thể được chèn vào các thủ tục tập lệnh xử lý dữ liệu đầu vào, tính toán, thao tác với tệp hoặc bất kỳ thủ tục nào mà việc cung cấp thông tin về quá trình thực hiện sẽ hữu ích.

Hộp thoại thông báo

Ngoài hộp thoại thông báo cơ bản có sẵn trong hệ thống tập lệnh (ShowMessage), còn có nhiều hộp thoại chuyên biệt để cung cấp phản hồi phù hợp cho người dùng.

Trong đó có các thủ tục thông báo như:

  • ShowError
  • ShowException
  • ShowInfo
  • ShowWarning
  • và nhiều thủ tục khác...

Bảng Messages

Bảng Messages của Altium Designer có thể là một công cụ hữu ích để gỡ lỗi tập lệnh, đồng thời cũng có thể được sử dụng để cung cấp liên tục các thông báo hữu ích cho người dùng trong quá trình chạy.

Bảng Messages là một đối tượng của Workspace Manager được truy cập thông qua giao diện Message Manager. Có thể sử dụng bảng Messages trong tập lệnh để hiển thị trạng thái của các biến và thuộc tính (hoặc bất kỳ dữ liệu nào khác), phục vụ cả việc gỡ lỗi lẫn cung cấp phản hồi cho người dùng, như minh họa trong ví dụ bên dưới.

Procedure CreateMessages;
var
   WS : IWorkSpace;
   MM : IMessagesManager;
Begin
   WS := GetWorkSpace;           // obtain Workspace Manager interface
   MM := WS.DM_MessagesManager;  // obtain Message Manager interface
   
   MM.ClearMessages;             // initialize

   MM.BeginUpdate;
   // add relevant messages here using MM.AddMesssage procedures
   MM.EndUpdate;

   WS.DM_ShowMessageView;         // display messages
End;
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