Penjanaan Kod dengan build_runner

Sesetengah kod ialah kod asas yang berulang, seperti penghuraian JSON. Penjanaan kod menulisnya untuk anda berdasarkan anotasi, supaya anda kekal tepat dan pantas. ⚙️

build_runner ialah alat Dart yang menjalankan penjana kod pada projek anda. Ia membaca fail sumber, mencari anotasi dan menghasilkan fail baharu.

Anda menambah build_runner di bawah dev_dependencies dalam pubspec.yaml kerana ia dijalankan semasa proses binaan dan tidak pernah dihantar bersama aplikasi anda.

Penjana menulis ke dalam fail bersebelahan. Anda memaut kepadanya dengan arahan part yang namanya secara konvensyen berakhir dengan .g.dart.

Cetuskan penjanaan sekali dengan arahan build. Arahan ini mengimbas kod anda dan mencipta atau menyegarkan setiap fail .g.dart.

Semasa pembangunan, mod watch menjana semula fail secara automatik setiap kali anda menyimpan. Fail yang dijana kekal segerak tanpa perlu menjalankan semula arahan secara manual.

Jika output bertembung dengan fail lama, tambahkan --delete-conflicting-outputs. Arahan ini memadam fail yang dijana dan sudah lapuk supaya binaan baharu dapat berjaya.

Penjana hanya bertindak pada pengisytiharan yang anda anotasi. Anotasi itu memberitahu pembina kelas yang perlu diproses dan kod yang perlu dihasilkan.

Anggap setiap fail .g.dart sebagai hanya baca. Binaan seterusnya akan menulis ganti perubahan anda, jadi edit sumber dan anotasi sebaliknya.

Pasukan boleh memilih untuk menyerahkan fail yang dijana atau menambahkannya ke .gitignore dan membina semula dalam CI. Apa-apa pun pilih satu dasar dan kekalkan konsistensinya.

Banyak pakej disepadukan dengan build_runner, seperti json_serializable dan freezed. Semuanya berkongsi satu aliran builder, jadi satu arahan dapat menjalankan kesemuanya.

build_runner menukarkan anotasi kepada fail .g.dart yang dijana. Tambahkannya ke dev_dependencies, jalankan build atau watch, dan jangan sekali-kali edit outputnya. 🎉