Вступ
У 2025 році розробка Android повністю базується на Kotlin + Jetpack Compose. Coroutines та Flow роблять асинхронні операції чистими, Hilt автоматизує впорскування залежностей, Room для локальної бази даних, Clean Architecture максимізує тестування. З Kotlin 2.3+ та Android Studio Meerkat+ навіть інтеграція KMP стала простою, але ми фокусуємося на чистому Android.

У цьому посібнику ми створимо з нуля додаток Погоди:

• Пошук міста + додавання до улюблених
• Інтеграція OpenWeatherMap API (з Flow)
• Локальний кеш з Room + підтримка офлайн
• UI Jetpack Compose (Material 3)
• Hilt DI + Coroutines + StateFlow
• Clean Architecture (data/domain/presentation)

Вимоги
Android Studio 2025.x, Kotlin 2.3+, minSdk 26+
Залежності Gradle (build.gradle.kts модуль app):
dependencies {
    implementation("androidx.core:core-ktx:1.13.1")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.6")
    implementation("androidx.activity:activity-compose:1.9.3")
    implementation(platform("androidx.compose:compose-bom:2025.xx.xx"))
    implementation("androidx.compose.ui:ui")
    implementation("androidx.compose.material3:material3")
    implementation("androidx.compose.ui:ui-tooling-preview")
    debugImplementation("androidx.compose.ui:ui-tooling")

    // Hilt
    implementation("com.google.dagger:hilt-android:2.52")
    ksp("com.google.dagger:hilt-compiler:2.52")
    implementation("androidx.hilt:hilt-navigation-compose:1.0.0")

    // Coroutines + Flow
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0")

    // Room
    implementation("androidx.room:room-runtime:2.6.1")
    implementation("androidx.room:room-ktx:2.6.1")
    ksp("androidx.room:room-compiler:2.6.1")

    // Retrofit + Converter
    implementation("com.squareup.retrofit2:retrofit:2.11.0")
    implementation("com.squareup.retrofit2:converter-gson:2.11.0")
    implementation("com.squareup.okhttp3:okhttp:4.12.0")

    // Coil for images
    implementation("io.coil-kt:coil-compose:2.7.0")
}
Для Hilt додайте клас Application та @HiltAndroidApp.

1. Структура проекту (Clean Architecture)
app/
|-- data/
|   |-- local/     # Room DAO, Entity
|   |-- remote/    # Retrofit API, DTO
|   |-- repository/# Impl Repository
|-- domain/
|   |-- model/     # Domain Entities
|   |-- repository/# Abstract Repository
|   |-- usecase/   # UseCases
|-- di/            # Hilt modules
|-- presentation/
|   |-- ui/        # Screens, Composables
|   |-- viewmodel/ # ViewModels
|-- util/
2. Шар Domain (Найчистіший)
domain/model/Weather.kt
data class Weather(
    val city: String,
    val temperature: Double,
    val description: String,
    val icon: String,
    val timestamp: Long = System.currentTimeMillis()
)
domain/repository/WeatherRepository.kt
interface WeatherRepository {
    suspend fun getWeather(city: String): Result<Weather>
    fun getFavoriteCities(): Flow<List<String>>
    suspend fun addFavorite(city: String)
    suspend fun removeFavorite(city: String)
}
Приклад UseCase: domain/usecase/GetWeatherUseCase.kt

class GetWeatherUseCase @Inject constructor(
    private val repository: WeatherRepository
) {
    suspend operator fun invoke(city: String): Result<Weather> = repository.getWeather(city)
}

3. Шар Data
Віддалений API (Retrofit)
data/remote/WeatherApi.kt
interface WeatherApi {
    @GET("weather")
    suspend fun getWeather(
        @Query("q") city: String,
        @Query("appid") apiKey: String,
        @Query("units") units: String = "metric"
    ): WeatherResponse
}

// DTO
data class WeatherResponse(
    val main: Main,
    val weather: List<WeatherItem>,
    val name: String
) {
    data class Main(val temp: Double)
    data class WeatherItem(val description: String, val icon: String)
}

Room Локальний
data/local/FavoriteCityEntity.kt
@Entity(tableName = "favorite_cities")
data class FavoriteCityEntity(
    @PrimaryKey val city: String
)
data/local/FavoriteDao.kt

@Dao
interface FavoriteDao {
    @Query("SELECT city FROM favorite_cities")
    fun getAll(): Flow<List<String>>

    @Insert(onConflict = OnConflictStrategy.IGNORE)
    suspend fun insert(city: FavoriteCityEntity)

    @Delete
    suspend fun delete(city: FavoriteCityEntity)
}

Реалізація Repository
data/repository/WeatherRepositoryImpl.kt
@Singleton
class WeatherRepositoryImpl @Inject constructor(
    private val api: WeatherApi,
    private val dao: FavoriteDao,
    private val apiKey: String // @Named або з BuildConfig
) : WeatherRepository {
    override suspend fun getWeather(city: String): Result<Weather> = try {
        val response = api.getWeather(city, apiKey)
        val weather = Weather(
            city = response.name,
            temperature = response.main.temp,
            description = response.weather.firstOrNull()?.description ?: "",
            icon = response.weather.firstOrNull()?.icon ?: ""
        )
        Result.success(weather)
    } catch (e: Exception) {
        Result.failure(e)
    }

    override fun getFavoriteCities(): Flow<List<String>> = dao.getAll()

    override suspend fun addFavorite(city: String) {
        dao.insert(FavoriteCityEntity(city))
    }

    override suspend fun removeFavorite(city: String) {
        dao.delete(FavoriteCityEntity(city))
    }
}

4. Модулі Hilt
di/AppModule.kt
@Module
@InstallIn(SingletonComponent::class)
object AppModule {
    @Provides
    @Singleton
    fun provideRetrofit(): Retrofit = Retrofit.Builder()
        .baseUrl("https://api.openweathermap.org/data/2.5/")
        .addConverterFactory(GsonConverterFactory.create())
        .build()

    @Provides
    @Singleton
    fun provideWeatherApi(retrofit: Retrofit): WeatherApi = retrofit.create(WeatherApi::class.java)

    // Room database vs.
}
5. ViewModel (StateFlow + Coroutines)
presentation/viewmodel/WeatherViewModel.kt
@HiltViewModel
class WeatherViewModel @Inject constructor(
    private val getWeatherUseCase: GetWeatherUseCase,
    private val repository: WeatherRepository
) : ViewModel() {
    private val _uiState = MutableStateFlow(WeatherUiState())
    val uiState: StateFlow<WeatherUiState> = _uiState.asStateFlow()

    private val _favorites = MutableStateFlow<List<String>>(emptyList())
    val favorites: StateFlow<List<String>> = _favorites.asStateFlow()

    init {
        viewModelScope.launch {
            repository.getFavoriteCities().collect { cities ->
                _favorites.value = cities
            }
        }
    }

    fun searchCity(city: String) {
        viewModelScope.launch {
            _uiState.update { it.copy(isLoading = true) }
            getWeatherUseCase(city).fold(
                onSuccess = { weather ->
                    _uiState.update { it.copy(weather = weather, error = null) }
                },
                onFailure = { e ->
                    _uiState.update { it.copy(error = e.message, isLoading = false) }
                }
            )
        }
    }

    fun toggleFavorite(city: String) {
        viewModelScope.launch {
            if (_favorites.value.contains(city)) {
                repository.removeFavorite(city)
            } else {
                repository.addFavorite(city)
            }
        }
    }
}

data class WeatherUiState(
    val weather: Weather? = null,
    val isLoading: Boolean = false,
    val error: String? = null
)
6. Екран Jetpack Compose
presentation/ui/WeatherScreen.kt
@Composable
fun WeatherScreen(viewModel: WeatherViewModel = hiltViewModel()) {
    val state by viewModel.uiState.collectAsStateWithLifecycle()
    val favorites by viewModel.favorites.collectAsStateWithLifecycle()
    var city by remember { mutableStateOf("") }

    Column(modifier = Modifier
        .fillMaxSize()
        .padding(16.dp)) {
        TextField(
            value = city,
            onValueChange = { city = it },
            label = { Text("Пошук міста (наприклад: Київ)") },
            modifier = Modifier.fillMaxWidth()
        )
        Spacer(Modifier.height(8.dp))
        Button(onClick = { viewModel.searchCity(city) }) {
            Text("Пошук")
        }
        if (state.isLoading) {
            CircularProgressIndicator(modifier = Modifier.align(Alignment.CenterHorizontally))
        }
        state.weather?.let { weather ->
            Card(modifier = Modifier
                .fillMaxWidth()
                .padding(top = 16.dp)) {
                Column(modifier = Modifier.padding(16.dp), horizontalAlignment = Alignment.CenterHorizontally) {
                    Text(weather.city, style = MaterialTheme.typography.headlineMedium)
                    AsyncImage(
                        model = "https://openweathermap.org/img/wn/${weather.icon}@2x.png",
                        contentDescription = null,
                        modifier = Modifier.size(100.dp)
                    )
                    Text("${weather.temperature.toInt()}°C", style = MaterialTheme.typography.bodyLarge)
                    Text(weather.description.capitalize())
                    IconButton(onClick = { viewModel.toggleFavorite(weather.city) }) {
                        Icon(
                            imageVector = if (favorites.contains(weather.city)) Icons.Filled.Favorite else Icons.Outlined.Favorite,
                            contentDescription = "Улюблене"
                        )
                    }
                }
            }
        }
        state.error?.let {
            Text(it, color = MaterialTheme.colorScheme.error)
        }
        // Список улюблених...
    }
}
7. Поради для просунутих (2025)

• Flow з offline-first: API > кеш > emit
• Додати стрічку новин з Paging 3 + RemoteMediator
• Прискорити процесор hilt з KSP
• Додати Baseline Profiles + Macrobenchmark
• Кастомні анотації з Kotlin Symbol Processing (KSP)

JavaScript — одна з найпоширеніших мов програмування для веб-розробки, яка пропонує безліч зручних технік. Однією з таких технік є методів ланцюжок (method chaining) — підхід, який дозволяє викликати кілька методів об'єкта послідовно в одному рядку коду. У цій статті ми розглянемо, що таке method chaining у JavaScript, як він працює, його переваги та практичні приклади. Цей матеріал оптимізований для SEO і буде корисним як для початківців, так і для досвідчених розробників.

---

Що таке Method Chaining у JavaScript?
Method chaining (ланцюжок методів) — це техніка, при якій методи об'єкта викликаються один за одним у вигляді ланцюжка, без необхідності зберігати проміжні результати в окремі змінні. Це можливо завдяки тому, що кожен метод повертає об'єкт (зазвичай той самий, з яким працюєш), дозволяючи викликати наступний метод на цьому об'єкті.
Цей підхід широко застосовується в популярних бібліотеках, таких як jQuery, і робить код більш компактним і читабельним.

---

Як Працює Method Chaining?
Щоб методи можна було викликати в ланцюжку, кожен із них повинен повертати об'єкт (найчастіше this — посилання на поточний об'єкт). Без цього ланцюжок перерветься, адже наступний метод не матиме об'єкта для роботи.

Простий приклад:
const користувач = {
    ім_я: "Олег",
    вік: 25,
    встановитиІм_я(нове_ім_я) {
        this.ім_я = нове_ім_я;
        return this; // Повертаємо об'єкт для ланцюжка
    },
    встановитиВік(новий_вік) {
        this.вік = новий_вік;
        return this; // Повертаємо об'єкт для ланцюжка
    },
    вивести() {
        console.log(`Ім'я: ${this.ім_я}, Вік: ${this.вік}`);
        return this; // Для продовження ланцюжка
    }
};

// Використання ланцюжка методів
користувач
    .встановитиІм_я("Марія")
    .встановитиВік(30)
    .вивести();
Результат:
Ім'я: Марія, Вік: 30
У цьому прикладі кожен метод повертає this, що дозволяє викликати наступний метод у ланцюжку.

---

Переваги Method Chaining

• Компактність коду: Замість кількох окремих рядків ви отримуєте один ланцюжок.
• Читабельність: Логічно пов'язані операції групуються разом.
• Зменшення проміжних змінних: Не потрібно створювати тимчасові змінні для зберігання результатів.

Приклад без ланцюжка:
користувач.встановитиІм_я("Іван");
користувач.встановитиВік(28);
користувач.вивести();
З ланцюжком код виглядає елегантніше.

---

Практичний Приклад: Маніпуляція Масивом
JavaScript має вбудовані методи для роботи з масивами, які також підтримують ланцюжок:
const числа = [1, 2, 3, 4, 5, 6];

// Фільтруємо, множимо і виводимо результат
const результат = числа
    .filter(num => num % 2 === 0) // Залишаємо парні числа
    .map(num => num * 2)          // Множимо на 2
    .reduce((sum, num) => sum + num, 0); // Сума всіх чисел

console.log(результат); // 20 (4 + 8 + 12)
Тут методи filter, map і reduce повертають новий масив або значення, дозволяючи будувати ланцюжок.

---

Створення Власного Ланцюжка Методів
Розглянемо приклад створення класу з підтримкою method chaining:
class Калькулятор {
    constructor(значення = 0) {
        this.значення = значення;
    }

    додати(число) {
        this.значення += число;
        return this;
    }

    відняти(число) {
        this.значення -= число;
        return this;
    }

    отриматиРезультат() {
        return this.значення;
    }
}

const кальк = new Калькулятор();
const результат = кальк
    .додати(10)
    .додати(5)
    .відняти(3)
    .отриматиРезультат();

console.log(результат); // 12
Цей приклад показує, як легко створювати власні об'єкти з підтримкою ланцюжка методів.

---

Обмеження та Недоліки

• Складність дебагінгу: Якщо в ланцюжку виникає помилка, важко визначити, де саме вона сталася.
• Не завжди інтуїтивно: Довгі ланцюжки можуть заплутати читача.
• Потрібне повернення this: Якщо метод не повертає об'єкт, ланцюжок обривається.

---

Method Chaining у Популярних Бібліотеках
Багато бібліотек, таких як jQuery, активно використовують ланцюжок методів:
$("p")
    .addClass("highlight")
    .css("color", "blue")
    .text("Привіт, світ!");
Цей код додає клас, змінює колір і встановлює текст для всіх параграфів на сторінці.

---

Висновок
Method chaining у JavaScript — це зручна техніка, яка дозволяє писати компактний і логічно зв'язаний код. Вона особливо корисна для роботи з об'єктами та масивами, а також широко застосовується в бібліотеках і фреймворках. Щоб використовувати її ефективно, переконайтеся, що ваші методи повертають об'єкт (this), і уникайте надто довгих ланцюжків для збереження читабельності.

Python — це мова програмування, яка славиться своєю простотою та потужністю. Одним із фундаментальних інструментів у Python є цикли, зокрема while цикл. У цій статті ми детально розглянемо, що таке while цикл, як він працює, його синтаксис і як його можна застосовувати на практиці. Цей матеріал оптимізований для SEO, тому він буде корисним як для новачків, так і для тих, хто шукає поглиблені знання про Python.

---

Що таке While Цикл у Python?
While цикл у Python — це конструкція, яка дозволяє виконувати певний блок коду доти, доки задана умова залишається істинною (True). Це відрізняє його від циклу for, який зазвичай використовується для ітерацій по заздалегідь відомій послідовності. While ідеально підходить для ситуацій, коли ви не знаєте наперед, скільки разів потрібно повторити дію.
Простіше кажучи, цикл while продовжує роботу, поки умова не стане хибною (False). Як тільки це стається, виконання циклу завершується.

---

Синтаксис While Циклу
Синтаксис циклу while у Python надзвичайно простий:
while умова:
    # Блок коду, який виконується, поки умова істинна

• умова: логічний вираз (наприклад, x > 0), який перевіряється перед кожною ітерацією.
• Блок коду: набір інструкцій, які виконуються, якщо умова істинна.

---

Як Працює While Цикл?
Щоб зрозуміти, як працює while, розглянемо простий приклад:
число = 5
while число > 0:
    print(f"Число дорівнює: {число}")
    число -= 1
Результат:
Число дорівнює: 5
Число дорівнює: 4
Число дорівнює: 3
Число дорівнює: 2
Число дорівнює: 1
У цьому прикладі:

• Змінна число спочатку дорівнює 5.
• Умова число > 0 перевіряється перед кожною ітерацією.
• Якщо умова істинна, виводиться значення змінної, а потім число зменшується на 1.
• Коли число стає 0, умова стає хибною, і цикл завершується.

---

Використання Break і Continue у While Циклі
Python дозволяє контролювати виконання циклу за допомогою ключових слів break і continue:

• break: Перериває цикл повністю, навіть якщо умова все ще істинна.
• continue: Пропускає поточну ітерацію і повертається до перевірки умови.

Приклад із break:
число = 10
while число > 0:
    print(f"Число: {число}")
    if число == 3:
        break
    число -= 1
Результат:
Число: 10
Число: 9
Число: 8
Число: 7
Число: 6
Число: 5
Число: 4
Число: 3
Цикл зупиняється, коли число дорівнює 3, завдяки break.

Приклад із continue:
число = 5
while число > 0:
    число -= 1
    if число == 2:
        continue
    print(f"Число: {число}")
Результат:
Число: 4
Число: 3
Число: 1
Число: 0
Число 2 пропущено через continue.

---

Нескінченний Цикл у While
Якщо умова завжди залишається істинною, цикл стає нескінченним. Наприклад:
while True:
    print("Цикл працює!")
    break  # Без break цикл ніколи не зупиниться
Нескінченні цикли корисні в певних сценаріях (наприклад, у програмах, які постійно чекають на введення користувача), але важливо додати умову зупинки (наприклад, break).

---

Практичний Приклад: Обчислення Факторіала
Розглянемо приклад обчислення факторіала числа за допомогою while:
n = 5
факторіал = 1
while n > 0:
    факторіал *= n
    n -= 1
print(f"Факторіал дорівнює: {факторіал}")
Результат:
Факторіал дорівнює: 120
Тут ми множимо числа від 5 до 1, отримуючи 5! = 120.

---

Переваги та Недоліки While Циклу
Переваги:

• Гнучкість: підходить для задач із невизначеною кількістю ітерацій.
• Простота: легко читається та реалізується.

Недоліки:

• Ризик нескінченного циклу: якщо умова неправильно сформульована, програма може зависнути.
• Потребує ручного оновлення змінних (на відміну від for).

---

Висновок
While цикл у Python — це потужний інструмент для автоматизації повторюваних дій. Завдяки своїй простоті та гнучкості він є незамінним у багатьох сценаріях програмування. Використовуйте його з обережністю, щоб уникнути нескінченних циклів, і комбінуйте з break та continue для більшого контролю.