XPage 一个非常方便的Android Fragment页面框架

╰+攻爆jí腚メ 2022-05-27 07:37 407阅读 0赞

# XPage #

[![XPage.svg][]][XPage.svg 1] [![api][]][api 1] [![I][]][I 1] [![Star][]][Star 1]

一个非常方便的fragment页面框架

## 关于我 ##

[![github][]][github 1] [![csdn][]][csdn 1]

## 特点 ##

*  支持assets下“corepage.json”静态配置Fragment页面信息。
 *  支持Application中动态配置Fragment页面信息。
 *  支持通过注解@Page的方式动态自动配置页面信息。
 *  支持自定义Fragment页面信息配置。
 *  支持4种默认Fragment页面切换动画。
 *  支持Fragment页面间参数传递。
 *  支持Fragment页面属性保存。
 *  支持Fragment页面的onKeyDown、onFragmentResult等生命周期
 *  支持Fragment和Fragment页面自由跳转以及数据交互。
 *  支持导航栏通过注解的方式自动添加及设置。

## 1、演示（请star支持） ##

![70][]

## 2、如何使用 ##

目前支持主流开发工具AndroidStudio的使用，直接配置build.gradle，增加依赖即可.

### 2.1、Android Studio导入方法，添加Gradle依赖 ###

1.先在项目根目录的 build.gradle 的 repositories 添加:

allprojects {
         repositories {
            ...
            maven { url "https://jitpack.io" }
        }
    }

2.然后在dependencies添加:

dependencies {
      ...
      //XPage
      implementation 'com.github.xuexiangjys.XPage:xpage-lib:2.1.3'
      annotationProcessor 'com.github.xuexiangjys.XPage:xpage-compiler:2.1.3'
      //butterknife的sdk
      implementation 'com.jakewharton:butterknife:8.4.0'
      annotationProcessor 'com.jakewharton:butterknife-compiler:8.4.0'
      //leak
      debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.5.4'
      releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
      testImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
    
    }

3.进行moduleName注册

defaultConfig {
        ...
    
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [ moduleName : project.getName() ]
            }
        }
    }

### 2.2、页面注册 ###

#### 2.2.1、assets中注册 ####

在assets文件夹中新建“corepage.json“，然后进行如下配置：

[
      {
        "name": "测试页面1",
        "classPath": "com.xuexiang.xpagedemo.fragment.TestFragment1",
        "params": ""
      },
      {
        "name": "测试页面2",
        "classPath": "com.xuexiang.xpagedemo.fragment.TestFragment2",
        "params": {
          "key1":"这是参数1的值",
          "key2":"这是参数2的值"
        }
      }，
    ]

#### 2.2.2、Application中注册 ####

1.手动动态进行页面注册

PageConfig.getInstance().setPageConfiguration(new PageConfiguration() {
        @Override
        public List<PageInfo> registerPages(Context context) {
            List<PageInfo> pageInfos = new ArrayList<>();
            addPageInfoAndSubPages(pageInfos, MainFragment.class);
            pageInfos.add(PageConfig.getPageInfo(DateReceiveFragment.class));
            return pageInfos;
        }
    }).debug("PageLog").init(this);

2.自动进行页面注册

使用apt自动生成的页面注册配置类 “moduleName”+PageConfig 的getPages()进行注册。

PageConfig.getInstance().setPageConfiguration(new PageConfiguration() {
        @Override
        public List<PageInfo> registerPages(Context context) {
            return AppPageConfig.getInstance().getPages();
        }
    }).debug("PageLog").init(this);

### 2.3、页面跳转 ###

#### 2.3.1、携带数据 ####

Bundle params = new Bundle();
        switch(position) {
            case 0:
                params.putBoolean(DateReceiveFragment.KEY_IS_NEED_BACK, false);
                int id = (int) (Math.random() * 100);
                params.putString(DateReceiveFragment.KEY_EVENT_NAME, "事件" + id);
                params.putString(DateReceiveFragment.KEY_EVENT_DATA, "事件" + id + "携带的数据");
                openPage(DateReceiveFragment.class, params);
                break;
            case 1:
                params.putBoolean(DateReceiveFragment.KEY_IS_NEED_BACK, true);
                openPageForResult(DateReceiveFragment.class, params, 100);
                break;
            default:
                break;
        }

#### 2.3.2、页面切换动画 ####

switch(position) {
            case 0:
                openPage(TestFragment.PAGE_NAME, null, CoreAnim.none);//没有动画
                break;
            case 1:
                openPage(TestFragment.PAGE_NAME, null, CoreAnim.present);//由下到上动画
                break;
            case 2:
                openPage(TestFragment.PAGE_NAME, null, CoreAnim.slide);//从左到右动画
                break;
            case 3:
                openPage(TestFragment.PAGE_NAME, null, CoreAnim.fade);//渐变
                break;
            case 4:
                openPage(TestFragment.PAGE_NAME, null, CoreAnim.zoom);//放大
                break;
            default:
                break;
        }

## 特别感谢 ##

[https://github.com/lizhangqu/CorePage/][https_github.com_lizhangqu_CorePage]

## 联系方式 ##

[![E7_82_B9_E6_88_91_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E7_BE_A4-602082750-blue.svg][]][E7_82_B9_E6_88_91_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E7_BE_A4-602082750-blue.svg 1]

![70 1][]

## 微信公众号 ##

![在这里插入图片描述][20190104152244834.jpg]

[XPage.svg]: https://jitpack.io/v/xuexiangjys/XPage.svg
[XPage.svg 1]: https://jitpack.io/#xuexiangjys/XPage
[api]: https://img.shields.io/badge/API-14+-brightgreen.svg
[api 1]: https://android-arsenal.com/api?level=14
[I]: https://img.shields.io/github/issues/xuexiangjys/XPage.svg
[I 1]: https://github.com/xuexiangjys/XPage/issues
[Star]: https://img.shields.io/github/stars/xuexiangjys/XPage.svg
[Star 1]: https://github.com/xuexiangjys/XPage
[github]: https://img.shields.io/badge/GitHub-xuexiangjys-blue.svg
[github 1]: https://github.com/xuexiangjys
[csdn]: https://img.shields.io/badge/CSDN-xuexiangjys-green.svg
[csdn 1]: http://blog.csdn.net/xuexiangjys
[70]: /images/20220527/a0a1d91959534098b83a2bf0bfb92104.png
[https_github.com_lizhangqu_CorePage]: https://github.com/lizhangqu/CorePage/
[E7_82_B9_E6_88_91_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E7_BE_A4-602082750-blue.svg]: https://img.shields.io/badge/%E7%82%B9%E6%88%91%E4%B8%80%E9%94%AE%E5%8A%A0%E5%85%A5QQ%E7%BE%A4-602082750-blue.svg
[E7_82_B9_E6_88_91_E4_B8_80_E9_94_AE_E5_8A_A0_E5_85_A5QQ_E7_BE_A4-602082750-blue.svg 1]: http://shang.qq.com/wpa/qunwpa?idkey=9922861ef85c19f1575aecea0e8680f60d9386080a97ed310c971ae074998887
[70 1]: /images/20220527/515e6b7ce56345d1953e411c4999d9b2.png
[20190104152244834.jpg]: /images/20220527/b3c491e5d1ba43dbaaeb0b0b4f86349c.png