0Pricing
Dart Academy · Pelajaran

Menyusun Library yang Siap Dipublikasikan

Menata lib, src, dan API publik

Menyusun Library yang Siap Dipublikasikan adalah pelajaran Dart Academy gratis di CoddyKit. Ini adalah pelajaran 1 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 Dart Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Dart Academy mencakup 4 pelajaran total.

Paket Hanyalah Folder

Sebuah paket Dart yang dapat dipublikasikan hanyalah folder dengan pubspec.yaml di akarnya. Satu berkas itu mengubah kode biasa menjadi sesuatu yang dapat dihosting oleh pub.dev. 📦

Folder lib adalah Rumah Publik

Semua hal yang ingin Anda izinkan untuk diimpor pengguna berada di bawah lib. Berkas yang langsung berada di dalam lib merupakan bagian dari permukaan publik paket Anda, jadi tempatkan dengan hati-hati.

Sembunyikan Internal di lib/src

Kode yang tidak ingin Anda tampilkan harus ditempatkan di lib/src. Berdasarkan konvensi, berkas-berkas ini merupakan detail implementasi privat dan tidak dimaksudkan untuk diimpor langsung oleh pengguna.

lib/
  my_package.dart
  src/
    helper.dart

Berkas Titik Masuk

Sebagian besar paket menyediakan satu berkas utama di lib yang namanya mengikuti nama paket. Titik masuk ini diimpor pengguna untuk mendapatkan seluruh pustaka Anda sekaligus.

import 'package:my_package/my_package.dart';

Ekspor Ulang dengan Kata Kunci export

Titik masuk Anda menggunakan export untuk menampilkan bagian-bagian dari lib/src yang benar-benar diperlukan pengguna. Anda menyusun satu API publik yang rapi dan terencana.

export 'src/calculator.dart';
export 'src/parser.dart';

Tentukan API Publik Anda dengan Sengaja

Kumpulan nama yang Anda ekspor adalah API publik Anda. Jagalah agar tetap kecil dan stabil karena setiap simbol yang diekspor merupakan janji kepada pengguna Anda.

Garis Bawah Berarti Privat

Nama yang diawali garis bawah bersifat privat tingkat pustaka dalam Dart. Bahkan di dalam lib/src, awali fungsi pembantu yang tidak ingin Anda bocorkan dengan satu garis bawah.

int _internalCount = 0;

Folder example

Tambahkan folder example dengan program kecil yang dapat dijalankan. Folder ini menunjukkan cara kerja paket Anda kepada pengguna dan memberi Anda poin tambahan di pub.dev. ✨

Pengujian Berada di test

Pengujian otomatis berada di folder test, di luar lib. Pengujian tersebut tidak dikirim kepada pengguna, tetapi membuktikan bahwa paket Anda berfungsi sesuai janji.

Berkas Tingkat Atas Itu Penting

Akar paket yang baik juga memuat README, CHANGELOG, dan LICENSE. Ketiga berkas ini adalah hal pertama yang ditampilkan pub.dev kepada pengunjung.

Tata Letak Bersih Sekilas Pandang

Jika disatukan, struktur tersebut terbaca seperti peta: lib untuk API, src untuk bagian internal, serta example, test, dan berkas metadata.

my_package/
  lib/
  example/
  test/
  pubspec.yaml

Pemeriksaan Singkat

Di mana Anda menempatkan kode yang harus tetap menjadi detail implementasi internal?

Ringkasan: Pustaka yang Rapi

Anda telah mempelajari tata letak: lib menyimpan API publik, lib/src menyembunyikan bagian internal, dan export menentukan apa yang dilihat pengguna. Dahulukan struktur, lalu publikasikan. 🚀

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Menyusun Library yang Siap Dipublikasikan” gratis?

Ya — teks lengkap “Menyusun Library yang Siap Dipublikasikan” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Dart Academy, upgrade ke CoddyKit PRO. Kursus Dart Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Menyusun Library yang Siap Dipublikasikan”?

Menata lib, src, dan API publik Kamu berlatih Dart 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 Dart Academy?

Tidak diperlukan pengalaman sebelumnya. Dart 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 1 dari 4.

Berapa lama pelajaran “Menyusun Library yang Siap Dipublikasikan” 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 Dart Academy ini?

Ya. Setiap pelajaran Dart 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. Menyusun Library yang Siap Dipublikasikan
  2. Mendokumentasikan dengan Komentar dartdoc
  3. Linting, Pemformatan, dan Skor pana
  4. dart pub publish ke pub.dev
← Kembali ke Dart Academy