Организация пакетов внутри модуля
Структура папок и пакетов, рассчитанная на рост
«Организация пакетов внутри модуля» — бесплатный урок Kotlin Multiplatform Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Kotlin Multiplatform Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Kotlin Multiplatform Academy содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
Packages Are Folders With Names
A package groups related Kotlin files under a dotted name. Good packages make a growing shared module easy to navigate. 📁
Declare the Package
Every file starts with a package line. It should mirror the folder path so the structure stays predictable for everyone.
package com.acme.shared.domainGroup by Feature
Prefer grouping by feature over grouping by type. A cart package keeps its model, logic, and helpers together in one place.
Separate Domain and Data
A clean split is domain for pure models and rules, and data for networking and storage. The boundary keeps each part focused.
// com.acme.shared.domain -> models, rules
// com.acme.shared.data -> api, dbUse a Reverse-Domain Root
Start packages with a reverse-domain name like com.acme.shared. It keeps your code from clashing with library packages.
Mirror Folders to Packages
Keep the folder tree matching the package names. When they line up, anyone can find a class just from its full name.
A Tidy Public Package
Put the types you expose in one obvious public package, like com.acme.shared.api. Callers then have a single place to look.
Tuck Internals Away
Keep helpers in an internal package such as .impl or .util. The name signals at a glance that callers should stay out.
Shallow Beats Deep
Avoid endless nesting. A shallow tree of a few clear packages is easier to scan than ten layers of tiny folders.
Same Layout Across Source Sets
Use the same package layout in commonMain, androidMain, and iosMain. Matching paths make expect and actual pairs easy to spot.
Names Tell a Story
Read your package list top to bottom. The names alone should explain what the module does and where each concern lives.
Quick Check
Let's check how to structure packages.
Recap
Group by feature or layer, mirror folders to packages, keep it shallow, and hide internals. A clear tree scales as the module grows. 🎉
Часто задаваемые вопросы
Урок «Организация пакетов внутри модуля» бесплатный?
Да — полный текст урока «Организация пакетов внутри модуля» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Kotlin Multiplatform Academy, подпишись на CoddyKit PRO. Курс Kotlin Multiplatform Academy содержит 4 уроков всего.
Чему я научусь в уроке «Организация пакетов внутри модуля»?
Структура папок и пакетов, рассчитанная на рост Ты практикуешь Kotlin Multiplatform Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Kotlin Multiplatform Academy?
Предыдущий опыт не требуется. Kotlin Multiplatform Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Организация пакетов внутри модуля»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Kotlin Multiplatform Academy?
Да. Каждый урок Kotlin Multiplatform Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Проектирование небольшого публичного API
- Видимость internal и public
- Организация пакетов внутри модуля
- Документирование API для обеих команд