Swift Academy · Pelajaran

Menguji dan Menyahpepijat Makro

Tulis ujian unit untuk pengembangan makro menggunakan assertMacroExpansion.

Pelajaran 4 daripada 413 langkah

Menguji dan Menyahpepijat Makro ialah pelajaran Swift Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Swift Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Swift Academy merangkumi sejumlah 4 pelajaran.

Mengapa Menguji Makro?

Makro menjana kod pada masa penyusunan. Ujian unit mengesahkan sumber yang dijana sebelum kod itu digunakan dalam pengeluaran.

// The swift-syntax package ships SwiftSyntaxMacrosTestSupport
// with assertMacroExpansion for testing macro output

assertMacroExpansion

assertMacroExpansion menerima sumber input dan sumber dikembangkan yang dijangka, kemudian mengesahkan bahawa kedua-duanya sepadan.

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 Dilampirkan

Sediakan struktur atau kelas yang dihiasi sebagai input dan sumber yang dikembangkan sepenuhnya sebagai hasil yang dijangka.

assertMacroExpansion(
  "@AddID struct User { var name: String }",
  expandedSource: """
  struct User {
    var name: String
    var id = UUID()
  }
  """,
  macros: ["AddID": AddIDMacro.self]
)

Menguji Penghasilan Diagnostik

Sahkan bahawa makro anda menghasilkan diagnostik yang betul, sama ada amaran atau ralat, apabila digunakan secara salah.

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]
)

Mengembangkan Makro dalam Xcode

Dalam Xcode, klik kanan panggilan makro dan pilih Expand Macro untuk memeriksa kod yang dijana sebaris.

// Before expansion:
let (v, s) = #stringify(1 + 2)
// After:
let (v, s) = (1 + 2, "1 + 2")

Menyahpepijat dengan print dalam Makro

Gunakan context.diagnose atau print untuk mencetak ke ralat standard bagi menyahpepijat logik makro semasa pembangunan.

// In macro implementation:
print("[StringifyMacro] expanding: \(node.description)", to: &standardError)

Titik Henti dalam Ujian Makro

Oleh sebab makro berjalan dalam proses yang sama semasa ujian, anda boleh menetapkan titik henti Xcode dalam pelaksanaan makro semasa ujian dijalankan.

// Set a breakpoint in StringifyMacro.expansion()
// Run the test target — breakpoints are hit

Pemeriksaan Pepohon Sintaks

Gunakan .debugDescription SwiftSyntax untuk mencetak keseluruhan pepohon sintaks nod input bagi tujuan penyahpepijatan.

print(node.debugDescription)
// Prints the full SyntaxTree hierarchy

Menguji Pelbagai Variasi Argumen

Tulis satu ujian bagi setiap bentuk argumen yang berbeza untuk memastikan semua laluan kod dalam makro diuji.

func testNoArgument() {
  assertMacroExpansion(
    "#stringify()",
    expandedSource: "#stringify()",
    diagnostics: [DiagnosticSpec(message: "Need an argument", line: 1, column: 1)],
    macros: ["stringify": StringifyMacro.self]
  )
}

Ujian Integrasi

Tambah sasaran aplikasi ujian yang benar-benar menggunakan makro tersebut. Sahkan penyusunan dan tingkah laku masa jalannya.

// In test app:
let (val, src) = #stringify(Date.now)
XCTAssertEqual(src, "Date.now")

CI untuk Ujian Makro

Jalankan ujian makro dalam CI seperti mana-mana pakej Swift yang lain: swift test dalam direktori pakej.

// CI command:
swift test --package-path MyMacros

Semakan Ringkas

Fungsi manakah yang mengesahkan bahawa makro berkembang menjadi kod sumber yang dijangka dalam ujian unit?

Jawab dalam pelajaran interaktif

Ulang Kaji Pelajaran

Uji makro dengan assertMacroExpansion untuk hasil yang betul dan DiagnosticSpec untuk kes ralat. Nyahpepijat dengan pratonton pengembangan Xcode dan titik henti dalam proses semasa ujian dijalankan. Jalankan melalui swift test dalam CI.

Percuma untuk bermula

Pelajari Swift dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 122
Pelajaran: 409

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Menguji dan Menyahpepijat Makro” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Swift Academy, termasuk “Menguji dan Menyahpepijat Makro”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Swift Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Menguji dan Menyahpepijat Makro”?

Tulis ujian unit untuk pengembangan makro menggunakan assertMacroExpansion. Anda berlatih Swift Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Swift Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Swift Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Menguji dan Menyahpepijat Makro” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Swift Academy ini?

Ya. Setiap pelajaran Swift Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

Peranan Makro: Freestanding berbanding Attached
Menulis Makro Ungkapan Freestanding
Makro Ahli Attached untuk Mengurangkan Kod Berulang
Menguji dan Menyahpepijat Makro

← Kembali ke Swift Academy