【新手教程】手把手教你如何引入DialogX到自己的项目里使用

此教程适用于 Android Studio 开发工具，要在自己的项目中使用 DialogX，除了直接将 DialogX 的所有代码集成进自己的项目中的方法外，你也可以直接引入现成的编译好的 DialogX 框架直接使用，这不会占用多少体积，我们实测过，DialogX 的主程序包在非混淆情况下占用空间约为 473 KB，引入额外的主题包，例如 IOS 主题样式会增加约 80.3 KB（上述统计数据统计于 0.0.46.beta15 版本），而这在你完成程序的开发编译为发布包（Relese）并混淆后只会更小，请勿担心。

引入

首先在 Android Studio 中打开你的项目代码：

在你的项目左侧的 Project 边栏中找到 “Gradle Scripts” 并打开其中的 “settings.gradle”，在右侧的 dependencyResolutionManagement{} 中添加以下代码，并点击屏幕上方的 “Sync Now” 按钮：

maven { url 'https://jitpack.io' }

等待完成后，再到左侧的 Project 边栏中找到 “Gradle Scripts” 并打开其中的 “build.gradle(Module: 项目名.app)”，在右侧的 dependencies{} 中添加以下代码：

请注意，dialogx_version 是版本号，如果你要引入其他 DialogX 的对话框主题，请务必保持使用一致的版本号，最新的版本可以在这里找到 ，请将下文中的版本号改为最新的版本。

def dialogx_version = "0.0.46.beta16"
implementation "com.github.kongzue.DialogX:DialogX:${dialogx_version}"

然后点击屏幕上方的 “Sync Now” 等待 Android Studio 完成引入，如果发生错误提示引入失败，请检查自己的网络是否能够正常访问 jitpack 中央仓库，或配置网络代理来解决网络引发的问题。

如果一切顺利，此时 DialogX 已经引入到你的项目中了。

使用

要使用 DialogX，你还需要进行初始化操作，请在你的项目中配置 Application，在其中进行配置。

如果你还没创建 Application，你可以按照如下操作：

首先请在左侧 Project 边栏中找到你的项目 app 目录下的 MainActivity，在其目录上点击右键，选择弹出菜单中的 “New” → “Java Class”

在弹出的对话框里起名 App：

回车完成创建，将你新建的 App 类设为 public 并继承 Application，并重写其 onCreate 方法，在其中初始化 DialogX，以下是详细代码：

import android.app.Application;
import com.kongzue.dialogx.DialogX;

public class App extends Application {
    
    @Override
    public void onCreate() {
        super.onCreate();
        DialogX.init(this);
    }
}

然后在左侧的 Project 边栏中找到 “manifest” 双击打开它，在 <Application> 标签中添加属性 android:name=".App"，完整代码如下：

<application
    android:name=".App"
    android:allowBackup="true"
    android:dataExtractionRules="@xml/data_extraction_rules"
    android:fullBackupContent="@xml/backup_rules"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.TestApp"
    tools:targetApi="31">
    
    ...

完成后，进入 MainActivity 编写代码，运行测试：

MessageDialog.show("测试标题", "测试内容", "OK");

测试运行：

运行成功！