Swift Academy · Pelajaran

Macro Member Attached untuk Mengurangi Boilerplate

Membuat init, CodingKeys, atau kesesuaian Equatable secara otomatis dengan macro member.

Pelajaran 3 dari 413 langkah

Macro Member Attached untuk Mengurangi Boilerplate adalah pelajaran Swift Academy gratis di CoddyKit. Ini adalah pelajaran 3 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.

Ringkasan Makro Member

Makro member terlampir menghasilkan member baru, seperti properti, metode, dan inisialisasi, langsung pada tipe yang diberi anotasi.

@AddID
struct User { var name: String }
// After expansion:
// struct User { var name: String; var id = UUID() }

Mematuhi MemberMacro

Implementasikan MemberMacro dan kembalikan array DeclSyntax yang merepresentasikan member baru.

import SwiftSyntaxMacros

struct AddIDMacro: MemberMacro {
  static func expansion(
    of node: AttributeSyntax,
    providingMembersOf decl: some DeclGroupSyntax,
    in context: some MacroExpansionContext
  ) throws -> [DeclSyntax] {
    return ["var id = UUID()"]
  }
}

Menghasilkan Inisialisasi

Makro member dapat menghasilkan inisialisasi khusus, menggantikan inisialisasi berbasis member jika diperlukan.

// Macro expansion returns:
[
  "init(name: String) { self.name = name; self.id = UUID() }"
]

Internal Makro @Observable

@Observable bawaan Swift menggunakan makro member untuk menambahkan infrastruktur observasi ke kelas Anda.

@Observable
class Counter {
  var count = 0
  // macro adds: _$observationRegistrar, access(), withMutation()
}

Membaca Tipe yang Diberi Anotasi

Akses properti tipe yang diberi anotasi melalui parameter decl untuk menghasilkan member yang sesuai dengan konteks.

if let structDecl = decl.as(StructDeclSyntax.self) {
  let members = structDecl.memberBlock.members
  // iterate to inspect stored properties
}

Mengekstrak Properti Tersimpan

Filter daftar member untuk mencari deklarasi variabel dengan pola properti tersimpan sebagai dasar pembuatan kode.

let storedProps = members.compactMap { member -> VariableDeclSyntax? in
  guard let varDecl = member.decl.as(VariableDeclSyntax.self),
        varDecl.bindingSpecifier.tokenKind == .keyword(.var)
  else { return nil }
  return varDecl
}

Menghasilkan Equatable dari Member

Makro @AutoEquatable dapat menghasilkan == dengan membandingkan setiap properti tersimpan.

// Generated code:
static func == (lhs: User, rhs: User) -> Bool {
  lhs.name == rhs.name && lhs.id == rhs.id
}

Menggabungkan Makro Member dan Conformance

Sering kali Anda memasangkan MemberMacro dengan ConformanceMacro untuk menambahkan member sekaligus mendeklarasikan kepatuhan protokol.

struct AutoEquatableMacro: MemberMacro, ConformanceMacro { ... }

Argumen Atribut

Makro Anda dapat menerima argumen yang menyesuaikan kode yang dihasilkannya.

@Clamped(range: 0...100)
var score: Int = 50
// macro reads range from attribute node and generates clamping accessors

Pelaporan Error Makro

Lempar MacroExpansionError atau hasilkan diagnostik ketika makro digunakan secara keliru.

guard decl.is(StructDeclSyntax.self) else {
  throw MacroError.message("@AddID can only be applied to structs")
}

Performa Pembangunan

Karena ekspansi berlangsung saat kompilasi, makro member tidak menambah beban saat eksekusi dan kode yang dihasilkan dapat disimpan dalam cache.

// All generated members are emitted as source code
// and compiled normally — no reflection at runtime

Pemeriksaan Singkat

Protokol apa yang harus dipatuhi oleh makro member terlampir?

Ringkasan Pelajaran

Makro member (MemberMacro) menghasilkan properti tersimpan, properti terhitung, dan inisialisasi untuk tipe yang diberinya anotasi. Baca member yang sudah ada pada tipe tersebut untuk menghasilkan kode yang peka konteks. Gabungkan dengan ConformanceMacro untuk menambahkan kepatuhan protokol juga.

Gratis untuk memulai

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 “Macro Member Attached untuk Mengurangi Boilerplate” gratis?

Ya — teks lengkap “Macro Member Attached untuk Mengurangi Boilerplate” 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 “Macro Member Attached untuk Mengurangi Boilerplate”?

Membuat init, CodingKeys, atau kesesuaian Equatable secara otomatis dengan macro member. 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 3 dari 4.

Berapa lama pelajaran “Macro Member Attached untuk Mengurangi Boilerplate” 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

  1. Peran Macro: Freestanding vs Attached
  2. Menulis Macro Ekspresi Freestanding
  3. Macro Member Attached untuk Mengurangi Boilerplate
  4. Menguji dan Men-debug Macro
← Kembali ke Swift Academy