Gỡ lỗi tập lệnh
Sơ lược
- 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.
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).
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:
- Điểm ngắt
- Chú giải công cụ đánh giá biểu thức
- Chú giải công cụ Insight
- Hộp thoại Evaluate
- Biểu thức theo dõi
► 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.
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 .
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”.
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
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.
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.
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;