Menguji dan Men-debug Macro
Menulis pengujian unit untuk ekspansi macro menggunakan assertMacroExpansion.
Menguji dan Men-debug Macro adalah pelajaran Swift Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Swift Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Swift Academy mencakup 4 pelajaran total.
Mengapa Makro Perlu Diuji?
Makro menghasilkan kode saat kompilasi. Pengujian unit memverifikasi kode sumber yang dihasilkan sebelum digunakan di produksi.
// The swift-syntax package ships SwiftSyntaxMacrosTestSupport
// with assertMacroExpansion for testing macro outputassertMacroExpansion
assertMacroExpansion menerima kode sumber masukan dan kode sumber hasil ekspansi yang diharapkan, lalu memverifikasi bahwa keduanya cocok.
import SwiftSyntaxMacrosTestSupport
import XCTest
final class StringifyMacroTests: XCTestCase {
func testStringify() throws {
assertMacroExpansion(
"#stringify(1 + 2)",
expandedSource: "(1 + 2, \"1 + 2\")",
macros: ["stringify": StringifyMacro.self]
)
}
}Menguji Makro Terlampir
Berikan struct/kelas yang diberi anotasi sebagai masukan dan kode sumber yang telah diperluas sepenuhnya sebagai keluaran yang diharapkan.
assertMacroExpansion(
"@AddID struct User { var name: String }",
expandedSource: """
struct User {
var name: String
var id = UUID()
}
""",
macros: ["AddID": AddIDMacro.self]
)Menguji Penerbitan Diagnostik
Verifikasi bahwa makro menghasilkan diagnostik yang benar, yaitu peringatan atau error, ketika digunakan secara keliru.
assertMacroExpansion(
"@AddID class Foo {}",
expandedSource: "class Foo {}",
diagnostics: [
DiagnosticSpec(message: "@AddID can only be applied to structs", line: 1, column: 1)
],
macros: ["AddID": AddIDMacro.self]
)Memperluas Makro di Xcode
Di Xcode, klik kanan pemanggilan makro dan pilih Luaskan Makro untuk memeriksa kode yang dihasilkan secara langsung.
// Before expansion:
let (v, s) = #stringify(1 + 2)
// After:
let (v, s) = (1 + 2, "1 + 2")Menelusuri Kesalahan dengan print dalam Makro
Gunakan context.diagnose atau print ke keluaran error standar untuk menelusuri logika makro selama pengembangan.
// In macro implementation:
print("[StringifyMacro] expanding: \(node.description)", to: &standardError)Titik Henti dalam Pengujian Makro
Karena makro berjalan dalam proses yang sama selama pengujian, Anda dapat memasang titik henti Xcode di dalam implementasi makro saat pengujian berlangsung.
// Set a breakpoint in StringifyMacro.expansion()
// Run the test target — breakpoints are hitInspeksi Pohon Sintaksis
Gunakan .debugDescription milik SwiftSyntax untuk mencetak seluruh pohon sintaksis simpul masukan saat menelusuri kesalahan.
print(node.debugDescription)
// Prints the full SyntaxTree hierarchyMenguji Berbagai Varian Argumen
Tulis satu pengujian untuk setiap bentuk argumen yang berbeda guna memastikan semua jalur kode dalam makro dijalankan.
func testNoArgument() {
assertMacroExpansion(
"#stringify()",
expandedSource: "#stringify()",
diagnostics: [DiagnosticSpec(message: "Need an argument", line: 1, column: 1)],
macros: ["stringify": StringifyMacro.self]
)
}Pengujian Integrasi
Tambahkan target aplikasi pengujian yang benar-benar menggunakan makro tersebut. Pastikan kompilasi dan perilaku saat eksekusi sudah benar.
// In test app:
let (val, src) = #stringify(Date.now)
XCTAssertEqual(src, "Date.now")CI untuk Pengujian Makro
Jalankan pengujian makro di CI seperti pada paket Swift lainnya: swift test di direktori paket.
// CI command:
swift test --package-path MyMacrosPemeriksaan Singkat
Fungsi apa yang memverifikasi bahwa makro diperluas menjadi kode sumber yang diharapkan dalam pengujian unit?
Ringkasan Pelajaran
Uji makro dengan assertMacroExpansion untuk memverifikasi keluaran yang benar dan DiagnosticSpec untuk kasus error. Telusuri kesalahan menggunakan pratinjau ekspansi Xcode dan titik henti dalam proses yang sama selama pengujian. Jalankan melalui swift test di CI.
Belajar Swift dengan tutor AI — gratis
Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.
- Kursus
- 122
- Pelajaran
- 409
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Menguji dan Men-debug Macro” gratis?
Ya — teks lengkap “Menguji dan Men-debug Macro” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Swift Academy, upgrade ke CoddyKit PRO. Kursus Swift Academy mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Menguji dan Men-debug Macro”?
Menulis pengujian unit untuk ekspansi macro menggunakan assertMacroExpansion. Kamu berlatih Swift Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai Swift Academy?
Tidak diperlukan pengalaman sebelumnya. Swift Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.
Berapa lama pelajaran “Menguji dan Men-debug Macro” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran Swift Academy ini?
Ya. Setiap pelajaran Swift Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- Peran Macro: Freestanding vs Attached
- Menulis Macro Ekspresi Freestanding
- Macro Member Attached untuk Mengurangi Boilerplate
- Menguji dan Men-debug Macro