【Android Studio】XUI框架的使用记录:源代码Demo安装+从Demo中获取捷径快速开发自己的APP

0 运行GitHub上的XUI的源代码

下载GitHub上的XUI源码并解压缩到当前文件夹后,用Android Studio打开该项目,开始了一系列的运作,后来报错,不用管它,关闭AS,重新打开,大部分都是因为网络问题导致有些包没有下好,重复两次就好了。

不过出现了下面的报警信息时:

[TAG] Failed to resolve variable '${junit.version}'
[TAG] Failed to resolve variable '${animal.sniffer.version}'

解决办法如下

  1. 首先:File----> Invalidate Caches/ Restart ---->点击Invalidate Caches/ Restart 重启Android Studio
  2. 然后:Build---->Clean Project
  3. 最后:安装到手机上

解决后,安装到手机上,体验一下这个功能丰富的Demo。

下面开始从这个Demo中获取需要的内容。

1 新建项目与添加依赖

1.1 新建项目(空项目)

New project ------> Empty Activity ------> 起名XUITest,编程语言java ------> finish。

1.2 添加Gradle依赖

1.2.1 根目录的 build.gradle 的 repositories

将左侧从默认的Android目录改为Project目录,在项目根目录的build.gradlerepositories中添加:

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

修改完成后,根目录的build.gradlerepositories完整内容如下:

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        google()
        jcenter()
        
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.2'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url "https://jitpack.io" } //只添加了这么一句
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

1.2.2 app中的 build.gradle 的 dependencies

打开app中的build.gradledependencies添加:

dependencies {
  ...
  //androidx项目
  implementation 'com.github.xuexiangjys:XUI:1.1.3'

  implementation 'androidx.appcompat:appcompat:1.1.0'
  implementation 'androidx.recyclerview:recyclerview:1.1.0'
  implementation 'com.google.android.material:material:1.1.0-beta01'
  implementation 'com.github.bumptech.glide:glide:4.11.0'
}

【注意】如果你的项目目前还未使用androidx,请使用如下配置:

dependencies {
  ...
  //support项目
  implementation 'com.github.xuexiangjys:XUI:1.0.9-support'

  implementation 'com.android.support:appcompat-v7:28.0.0'
  implementation 'com.android.support:recyclerview-v7:28.0.0'
  implementation 'com.android.support:design:28.0.0'
  implementation 'com.github.bumptech.glide:glide:4.8.0'
}

判断是否使用了androidx的方法如下:
如果原来的dependencies中带着类似androidx.的东西,就说明用的是androidx

androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'

搞定后,app中的 build.gradle完整的版本:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 29
    buildToolsVersion "29.0.3"
    defaultConfig {
        applicationId "com.example.xuitest"
        minSdkVersion 17
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'

    //androidx项目
    implementation 'com.github.xuexiangjys:XUI:1.1.3'

    //implementation 'androidx.appcompat:appcompat:1.1.0'   与上面重复了
    implementation 'androidx.recyclerview:recyclerview:1.1.0'
    implementation 'com.google.android.material:material:1.1.0-beta01'
    implementation 'com.github.bumptech.glide:glide:4.11.0' 
}

1.2.3 报错与解决

报错信息:
ERROR: Manifest merger failed : uses-sdk:minSdkVersion 15 cannot be smaller than version 17 declared in library
解决:
将当前项目的所支持的最小SDK版本改为17即可。具体做法为:打开app中的build.gradle,将里面的minSdkVersion 15改成minSdkVersion 17

2 初始化XUI设置

2.1 在Application最顶部初始化设置(必须)

左侧目录切换回Android目录,在app下的新建一个java类,如下图所示:
【Android Studio】XUI框架的使用记录:源代码Demo安装+从Demo中获取捷径快速开发自己的APP_第1张图片
建好后,MyApp.java内容如下:

package com.example.xuitest;

import android.app.Application;

public class MyApp extends Application {

}

定义一个onCreate方法,进行如下初始化:

XUI.init(this); //初始化UI框架
XUI.debug(true);  //开启UI框架调试日志

完成后,整个MyApp.java内容如下:

package com.example.xuitest;

import android.app.Application;

import com.xuexiang.xui.XUI;

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        XUI.init(this); //初始化UI框架
        XUI.debug(true);  //开启UI框架调试日志
    }
}

然后,需要去manifest文件夹下的AndroidManifestx.xml中添加配置:

android:name=".MyApp"

完成后,整个AndroidManifestx.xml配置文件:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.xuitest">

    <application
        android:name=".MyApp"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

2.2 调整应用的基础主题(必须)

必须设置应用的基础主题,否则组件将无法正常使用!必须保证所有用到XUI组件的窗口的主题都为XUITheme的子类,这非常重要!!!

基础主题类型:

大平板(10英寸, 240dpi, 1920*1200):XUITheme.Tablet.Big

小平板(7英寸, 320dpi, 1920*1200):XUITheme.Tablet.Small

手机(4.5英寸, 320dpi, 720*1280):XUITheme.Phone

从这个AndroidManifestx.xml的下述位置找到styles.xml,并将主题替换成想要的主题:
【Android Studio】XUI框架的使用记录:源代码Demo安装+从Demo中获取捷径快速开发自己的APP_第2张图片
【Android Studio】XUI框架的使用记录:源代码Demo安装+从Demo中获取捷径快速开发自己的APP_第3张图片
替换完成后,将里面的那些零碎删除,完成后整个styles.xml内容为:

<resources>

    <!-- Base application theme. -->
    <style name="AppTheme" parent="XUITheme.Phone">

    </style>

</resources>

当然也可以在Activity刚开始时调用如下代码动态设置主题(此处暂时不管):

@Override
protected void onCreate(Bundle savedInstanceState) {
    XUI.initTheme(this);
    super.onCreate(savedInstanceState);
    ...
}

2.3 调整字体库(对字体无要求的可省略)

(步骤1)设置你需要修改的字体库路径(assets下)

//设置默认字体为华文行楷,这里写你的字体库
XUI.getInstance().initFontStyle("fonts/hwxk.ttf");

(步骤2)在项目的基础Activity中加入如下代码注入字体

@Override
protected void attachBaseContext(Context newBase) {
    //注入字体
    super.attachBaseContext(CalligraphyContextWrapper.wrap(newBase));
}

2.4 混淆配置

-keep class com.xuexiang.xui.widget.edittext.materialedittext.** { *; }

3 写个按钮实现一些弹窗功能

最终功能如下,一个按钮,按了弹出提示弹窗:
【Android Studio】XUI框架的使用记录:源代码Demo安装+从Demo中获取捷径快速开发自己的APP_第4张图片
为了实现上述简单功能,所有需要修改的内容,以及修改后的结果如下。

(1)activity_main.xml中内容:

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/btn_test"
        style="@style/Button.Blue"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="弹窗"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

(2)MainActivity.java中内容:

package com.example.xuitest;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.view.View;

import com.xuexiang.xui.widget.dialog.materialdialog.MaterialDialog;

public class MainActivity extends AppCompatActivity implements View.OnClickListener{

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        findViewById(R.id.btn_test).setOnClickListener(this);

    }

    @Override
    public void onClick(View v) {
        new MaterialDialog.Builder(this)
                .iconRes(R.drawable.icon_tip)
                .title(R.string.tip_infos)
                .content(R.string.content_simple_confirm_dialog)
                .positiveText(R.string.lab_submit)
                .show();
    }
}

(3)需要拷贝icon_tip.png图片到drawable文件夹:
在这里插入图片描述
(4)需要在app/res/values/string.xml添加内容,完成后,完整的文件如下:

<resources>
    <string name="app_name">XUITest</string>


    <!--MaterialDialog-->
    <string name="tip_bluetooth_permission">是否允许打开蓝牙?</string>
    <string name="lab_yes"></string>
    <string name="lab_no"></string>
    <string name="tip_infos">提示</string>
    <string name="content_simple_confirm_dialog">请注意,这是一个简单的提示性对话框!</string>
    <string name="lab_submit">确定</string>
    <string name="tip_warning">警告</string>
    <string name="content_warning">当前为开发环境,是否切换到真实环境?</string>
    <string name="lab_change">切换</string>
    <string name="lab_continue">继续</string>
    <string name="hint_please_input_password">请输入密码</string>
    <string name="tip_options">选项</string>
    <string name="tip_router_setting">路线设置</string>
    <string name="lab_choice">选择</string>
    <string name="tip_update">版本更新</string>
    <string name="content_downloading">正在下载中,请稍后...</string>
    <string name="tip_download_finished">下载完毕!</string>
    <string name="lab_cancel">取消</string>
    <string name="content_wait_for_receive_data">数据接收中,请稍后...</string>
    <string name="lab_edit">编辑</string>
    <string name="lab_add">添加</string>
    <string name="lab_delete">删除</string>
    <string name="lab_update">更新</string>
    <string name="tip_please_select_transfer_type">选择一种切换方式</string>
    <string name="tip_signature">签名</string>
    <string name="lab_clear">清除</string>
    <string name="tip_loading_message">正在加载数据...</string>
    <string name="tip_start">开始</string>
    <string name="tip_stop">停止</string>

</resources>

参考大佬的链接都在这了:
GitHub:XUI源码
Bilibili:XUI基础入门
Bilibili:在项目中使用XUI
Bilibili:使用模板工程

你可能感兴趣的:(Android)