俗话说,代码是最好的老师,阅读源码是一个非常好的习惯。使用说明文档写得再仔细,也会有遗漏不足的地方,因此我鼓励大家在使用XUI的时候,结合演示Demo的代码进行开发,这样比一点一点翻文档有效的多!

由于XUI是一个Android原生UI库,它不像WebUI库那样,可以很方便地在浏览器中直接看到代码和代码实时的运行效果,因此我才详细编写了XUI的演示Demo程序,大家可以下载或者自己运行(建议)XUI演示demo程序,找到自己想要使用的组件,然后找到对应的实现代码来使用XUI的组件,下面我将分步骤讲解。

1、下载/运行Demo程序

在此之前,请确保正确引入了XUI,如果还没有引入的话,请先根据如何引用的指示,一步一步引入XUI。

下载Demo程序

  • 蒲公英下载【推荐】蒲公英

正确使用XUI的姿势 - 图2

  • Github下载Github

正确使用XUI的姿势 - 图4

运行Demo程序【推荐】

1.下载XUI源代码

  1. git clone https://github.com/xuexiangjys/XUI.git

2.使用Android Studio打开XUI项目,这里推荐使用Android Studio 3.4.1以上的版本打开。

代码运行需要注意的几点:

  • 如果出现一堆Unable to resolve dependency for xxxx,那是项目依赖的版本库没有下载成功,这个和你当前的网络有关。网速慢的话,依赖库可能下载很慢(timeout),多试几次就行了。

  • 由于Demo中使用了我的另一个页面框架库XPage, demo中的代码有一个AppPageConfig的类是编译时自动生成的,如果提示类找不到的话是没有关系的,Build一下就出来了,当然你也可以直接运行。

  • 演示Demo的程序跑通是肯定没有任何问题的,不行就多clean几下再运行,如果你依然没有跑成功,那就请你检查自己的环境是否都配置正确了!

2、选择你想要使用的组件,找到对应的示例代码

找到演示页面的标题,决定搜索内容

所有的演示页面理论上都是有标题的,有的还有副标题,如题下所示:

图1图2

搜索内容的公式如下:

  1. //无副标题
  2. 搜索内容 = 主标题;
  3. //有副标题
  4. 搜索内容 = 主标题 + "\n" + 副标题;

下面我以上图2为例:

主标题:Dialog构建策略 —-> 搜索内容: Dialog构建策略

主标题:MaterialDialog, 副标题:对话框。 —-> 搜索内容: MaterialDialog\n对话框

【切记】:千万不要少掉一个\

根据搜索内容进行搜索

使用Android Studio的全文搜索进行搜索,选择带有@Page的类,示例图如下:

图1图2

选中结果后,该类基本上就是你所需要的示例代码所在的Fragment页面了,接下来的任务就是死抠示例代码的实现逻辑了!