XPage是一个非常方便的fragment页面框架!天下武功,唯快不破,XPage最大的特点就是快,提高开发的效率!
XPage设计的初衷是希望能做一个通用的Activity作为壳,Fragment作为页面填充展示,并且能够像Activity那样自由的切换和数据交互。
当初做Android开发时每当我写一个页面,都需要创建一个Activity,并且还需要在manifest中注册一堆Activity信息,这样既不方便,而且对资源的开销也比较大。因此当时我就设想能否创造出一个通用万能的Activity容器,可以全权负责Fragment的切换展示和数据交互,只需要一行代码即可完成所有的操作,还不需要自己手动去注册,可以一键生成。
刚开始的时候真的很难,没有什么好的思路,最初只是简单封装了一个Activity,通过传入一些key值从而获取并加载对应的fragment,类似ARouter
中Fragment发现那种。其实这样做并没有解决一个容器的问题,而且页面切换也不是很灵活,不够通用,使用起来也不是很方便。
突然有一天我发现Github上有个开源项目CorePage写得非常好,完美地解决了我对一个Activity容器的问题,于是我决定仔细研究其代码,并在其基础上设计出了XPage的最初版本。
就在XPage正式投入使用的过程中,我发现还是存在不少问题的:
对于API不够灵活的问题,我在之后的版本中陆续通过构造者模式设计以及Android主题属性等手段解决了。
而对于手动注册的问题,我正是借鉴了ARouter的思路,通过Android APT技术,从而实现了Fragment信息的自动注册。
build.gradle
的 repositories 添加jitpack
仓库allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
以下是版本说明,选择一个即可。
dependencies {
...
// XPage
implementation 'com.github.xuexiangjys.XPage:xpage-lib:3.0.0'
annotationProcessor 'com.github.xuexiangjys.XPage:xpage-compiler:3.0.0'
// ButterKnife的sdk
implementation 'com.jakewharton:butterknife:10.1.0'
annotationProcessor 'com.jakewharton:butterknife-compiler:10.1.0'
}
dependencies {
...
// XPage
implementation 'com.github.xuexiangjys.XPage:xpage-lib:2.3.0'
annotationProcessor 'com.github.xuexiangjys.XPage:xpage-compiler:2.3.0'
// ButterKnife的sdk
implementation 'com.jakewharton:butterknife:8.4.0'
annotationProcessor 'com.jakewharton:butterknife-compiler:8.4.0'
}
【注意】如果你使用的是kotlin,请使用如下配置:
apply plugin: 'kotlin-kapt'
dependencies {
...
//XPage
implementation 'com.github.xuexiangjys.XPage:xpage-lib:3.0.0'
kapt 'com.github.xuexiangjys.XPage:xpage-compiler:3.0.0'
//ButterKnife的sdk
implementation 'com.jakewharton:butterknife:10.1.0'
kapt 'com.jakewharton:butterknife-compiler:10.1.0'
}
defaultConfig {
...
javaCompileOptions {
annotationProcessorOptions {
arguments = [ moduleName : project.getName() ]
}
}
}
【注意】:如果不注册的话,默认ModuleName为app
。
1.自动进行页面注册【推荐】
使用apt编译时自动生成的页面注册配置类 "moduleName"+PageConfig 的getPages()进行注册。
PageConfig.getInstance()
.setPageConfiguration(new PageConfiguration() { //页面注册
@Override
public List<PageInfo> registerPages(Context context) {
//自动注册页面,是编译时自动生成的,build一下就出来了。如果你还没使用@Page的话,暂时是不会生成的。
return AppPageConfig.getInstance().getPages(); //自动注册页面
}
})
.debug("PageLog") //开启调试
.setContainActivityClazz(XPageActivity.class) //设置默认的容器Activity
.enableWatcher(false) //设置是否开启内存泄露监测
.init(this); //初始化页面配置
【注意】:如果你的项目中只是增加了依赖,还没有使用@Page注解XPageFragment页面的话,在编译时是不会自动生成注册页面的!!
2.手动动态进行页面注册
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") //开启调试
.enableWatcher(false) //设置是否开启内存泄露监测
.init(this); //初始化页面配置
在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的值"
}
},
]
# fastjson
-dontwarn com.alibaba.fastjson.**
-keep class com.alibaba.fastjson.** { *; }
-keepattributes Signature
# xpage
-keep class com.xuexiang.xpage.annotation.** { *; }
使用XPage,Activity必须要继承
XPageActivity
,Fragment必须要继承XPageFragment
,否则将无法调用页面跳转的openPage
方法。
openPage
即可打开页面,入参可为跳转类的类名,也可以是类的标识(@Page标注的name字段)// 使用类名打开
openPage(TestFragment.class);
// 使用标识打开
openPage("TestFragment");
popToBack
即可关闭页面。// 关闭当前页,返回上一页
popToBack();
// 关闭当前页并跳转至某个页面
popToBack("popBackName", null);
openPageForResult
即可,类似Activity里的startActivityForResult
。openPageForResult(TestFragment.class, null, REQUEST_CODE);
setFragmentResult
来设置页面关闭的返回值,类似Activity里的setResult
方法。// 设置返回的数据,类似Activity里的setResult
Intent intent = new Intent();
intent.putExtra(KEY_BACK_DATA, "==【返回的数据】==");
setFragmentResult(500, intent);
// 返回操作
popToBack();
onFragmentResult
方法来接收返回的数据,类似Activity里的onActivityResult
方法。@Override
public void onFragmentResult(int requestCode, int resultCode, Intent data) {
super.onFragmentResult(requestCode, resultCode, data);
if (data != null) {
Bundle extras = data.getExtras();
XToastUtils.toast("requestCode:" + requestCode + " resultCode:" + resultCode + " data:" + extras.getString(TestFragment.KEY_BACK_DATA));
}
}
openPage
打开页面时,可传入Bundle作为参数。// 设置需要传递的参数
Bundle params = new Bundle();
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);
数据接收和普通Fragment接收数据一样,使用getArguments
获取传入的数据。
Bundle arguments = getArguments();
String eventName = arguments.getString(DateReceiveFragment.KEY_EVENT_NAME);
String eventData = arguments.getString(DateReceiveFragment.KEY_EVENT_DATA);
页面转场动画可以动态设置,也可以静态设置。
在我们使用@Page
进行页面注册的时候,我们可以静态设置转场动画、默认参数、拓展字段等。
Page注解的属性表:
属性名 | 类型 | 默认值 | 备注 |
---|---|---|---|
name | String | 注解类的类名 | 页面的名称、唯一标识符 |
params | String[] | {""} | 静态设置默认参数 |
anim | CoreAnim | CoreAnim.slide | 页面转场动画 |
extra | int | -1 | 拓展字段 |
使用openPage
打开页面时,可传入CoreAnim枚举设置页面转场动画。
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;
}
//自定义动画
openPage(TestFragment.PAGE_NAME, null, new int[]{
// OpenEnterAnimation, 页面打开进场动画
R.anim.custom_open_enter,
// OpenExitAnimation, 页面打开退场动画
R.anim.custom_open_exit,
// CloseEnterAnimation, 页面关闭进场动画
R.anim.custom_close_enter,
// CloseExitAnimation, 页面关闭退场动画
R.anim.custom_close_exit
});
使用PageOption.to
进行页面选项构建。
PageOption.to(TestFragment.class) //跳转的fragment
.setAnim(CoreAnim.zoom) //页面转场动画
.setRequestCode(100) //请求码,用于返回结果
.setAddToBackStack(true) //是否加入堆栈
.setNewActivity(true, ContainActivity.class) //是否使用新的Activity打开
.putBoolean(DateReceiveFragment.KEY_IS_NEED_BACK, true) //传递的参数
.open(this); //打开页面进行跳转
可以设置XPageTitleBarStyle
主题样式来自定义标题栏的默认样式。
<!-- Base application theme. -->
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
<!-- Customize your theme here. -->
<item name="colorPrimary">@color/xpage_default_actionbar_color</item>
<item name="colorPrimaryDark">@color/xpage_default_actionbar_color</item>
<item name="colorAccent">@color/xpage_default_actionbar_color</item>
<!--标题栏的背景图片,优先使用背景图片,没有背景图片才使用背景颜色,可选-->
<item name="xpage_actionbar_background">@null</item>
<!--标题栏的背景颜色-->
<item name="xpage_actionbar_color">@color/xpage_default_actionbar_color</item>
<!--是否支持沉浸式标题栏, 默认false-->
<item name="xpage_actionbar_immersive">false</item>
<!--标题栏返回箭头, 默认R.drawable.xpage_ic_navigation_back_white-->
<item name="xpage_actionbar_navigation_back">@drawable/xpage_ic_navigation_back_white</item>
<!--标题栏的高度,默认52dp-->
<item name="xpage_actionbar_height">60dp</item>
<!--标题栏标题文字的大小,默认18sp-->
<item name="xpage_actionbar_title_text_size">21sp</item>
<!--标题栏副标题文字的大小,默认12sp-->
<item name="xpage_actionbar_sub_text_size">14sp</item>
<!--标题栏动作文字的大小,默认15sp-->
<item name="xpage_actionbar_action_text_size">18sp</item>
<!--标题栏动作图片的padding,默认5dp-->
<item name="xpage_actionbar_action_padding">6dp</item>
<!--标题栏两侧文字的padding,默认14dp-->
<item name="xpage_actionbar_side_text_padding">16dp</item>
<item name="XPageTitleBarStyle">@style/XPageTitleBar.Custom</item>
</style>
<style name="XPageTitleBar.Custom">
<item name="tb_immersive">false</item>
<item name="tb_centerGravity">center</item>
</style>
详细可参见BottomNavigationViewFragment
就像正常使用ViewPager加载Fragment那样。但是这里需要注意的两点是:
@Override
protected TitleBar initTitleBar() {
//不使用@Page标注的一定要注意覆盖这个方法
return null;
}
PageOption.to(TestFragment.class)
//新建一个容器,以不影响当前容器
.setNewActivity(true)
.open(this);
详细可参见ComplexActivity
1.自定义页面容器的布局,在布局中一定要包含idfragment_container
。
<FrameLayout
android:id="@id/fragment_container"
android:layout_width="match_parent"
android:layout_height="400dp">
</FrameLayout>
2.在XPageActivity中设置页面容器的布局ID
@Override
protected int getLayoutId() {
return R.layout.activity_complex;
}
3.使用changePage
方法切换Fragment。
changePage(TestFragment.PAGE_NAME, null, CoreAnim.none);
【注意】在切换Fragment的时候,fragment并不会走onResume和onPause生命周期,建议使用onHiddenChanged代替。
4.使用getPage
方法获取指定的Fragment,就可以获取该fragment页面中的数据。
TabAFragment tabAFragment = getPage(TabAFragment.class);
if (tabAFragment != null) {
ToastUtils.toast(tabAFragment.getData());
} else {
ToastUtils.toast("页面还未加载!");
}
找不到AppPageConfig
?答:首先需要明确的是,AppPageConfig
是需要编译之后才会出现的,如果你没有编译的话,是肯定没有的。如果你编译了还是找不到,你可以根据如下步骤依次进行排查:
@Page
注解了,如果没有的话,即使编译了也是不会生成AppPageConfig
文件的。"moduleName"+PageConfig
的规则进行自动生成的,如果没有配置moduleName的话,默认才是app,这样自动生成的注册类才是AppPageConfig
。如果你配置了moduleName,而且模块的名称也不是app,那么自动生成的注册类肯定不是AppPageConfig
。本文分享自 我的Android开源之旅 微信公众号,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文参与 腾讯云自媒体同步曝光计划 ,欢迎热爱写作的你一起参与!