# Jetpack-Fly

**Repository Path**: tiamosu/Jetpack-Fly

## Basic Information

- **Project Name**: Jetpack-Fly
- **Description**: 一个集成 JetPack 组件库：LiveData、ViewModel、Lifecycles、DataBinding、Navigation 的快速开发框架；提供支持 Navigation 上 Fragment 的 Add、Hide 切换，通过 setMaxLifecycle 适配 Fragment 的真实可见性以及 Fragment 对于 Back键 的监听事件处理。
- **Primary Language**: Kotlin
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 0
- **Created**: 2022-07-07
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

# Jetpack-Fly

<div align=center><img src="img/logo.webp"></div>

## Wiki

[详细使用方法及扩展功能，请参照 Wiki (开发前必看!!!)](https://github.com/tiamosu/Jetpack-Fly/wiki)

## Requirements

适用于 Android 5.0 + (21 + API级别) 和 Java 11 +。

## Download

```groovy
allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }

        // sonatype
        maven { url "https://s01.oss.sonatype.org/content/groups/public" }
        maven { url "https://s01.oss.sonatype.org/content/repositories/releases" }
    }
}
```

### jfly-core（必选）

```groovy
implementation 'com.gitee.tiamosu:jfly-core:1.2.6'
```

### jfly-navigation（可选）

```groovy
implementation 'com.gitee.tiamosu:jfly-navigation:1.2.6'
```

* 需排除本地或第三方依赖中的
  navigation-fragment，防止与 [NavHostFragment](https://github.com/tiamosu/Jetpack-Fly/blob/master/fly-navigation/src/main/java/androidx/navigation/fragment/NavHostFragment.kt)
  修改版冲突，示例如下：

```groovy
implementation("androidx.navigation:navigation-fragment-ktx:2.5.3") {
    exclude group: 'androidx.navigation', module: "navigation-fragment"
}
```

### jfly-viewbinding（可选）

```groovy
implementation 'com.gitee.tiamosu:jfly-viewbinding:1.2.6'

android {
    buildFeatures {
        viewBinding = true
        dataBinding = true
    }
}
```

## Dependencies

### jfly-core

```groovy
dependencies {
    //androidx
    api Deps.appcompat
    api Deps.fragment_ktx
    api Deps.core_ktx

    //lifecycle
    api Deps.lifecycle_runtime_ktx
    api Deps.lifecycle_livedata_ktx
    api Deps.lifecycle_viewmodel_ktx
}
```

### jfly-navigation

```groovy
dependencies {
    implementation project(path: ':fly-core')
    api(Deps.navigation_fragment_ktx) {
        exclude group: 'androidx.navigation', module: "navigation-fragment"
    }
}
```

### jfly-viewbinding

```groovy
dependencies {
    implementation project(path: ':fly-core')
    implementation Deps.recyclerview
}
```

## Proguard

本框架已配置混淆，工程会自动传递混淆，使用时无需另行配置。

* jfly-core: [android-rules.pro](https://github.com/tiamosu/Jetpack-Fly/blob/master/fly-core/android-rules.pro)

* jfly-viewbinding：[consumer-rules.pro](https://github.com/tiamosu/Jetpack-Fly/blob/master/fly-viewbinding/consumer-rules.pro)

## [更新日志](https://github.com/tiamosu/Jetpack-Fly/blob/master/CHANGELOG.md)

## *特别感谢*

* [AndroidUtilCode](https://github.com/Blankj/AndroidUtilCode)
* [AndroidProject](https://github.com/getActivity/AndroidProject)
* [Jetpack-MVVM-Best-Practice](https://github.com/KunMinX/Jetpack-MVVM-Best-Practice)
* [ViewBindingPropertyDelegate](https://github.com/androidbroadcast/ViewBindingPropertyDelegate)