搭建小米手机App开发环境完整指南

一、基础环境准备

1. 安装Java开发环境

# 对于Ubuntu/Debian系统
sudo apt update
sudo apt install openjdk-11-jdk
java -version  # 验证安装

# 对于统信UOS
sudo apt install openjdk-11-jdk

2. 安装Android Studio

1. 从官网下载最新版Android Studio：
   https://developer.android.com/studio
2. 解压并安装：

   tar -xvf android-studio-*.tar.gz -C ~/
   cd ~/android-studio/bin
   ./studio.sh
   

3. 按照向导完成初始设置

3. 安装Android SDK

在Android Studio中：

1. 打开SDK Manager (Configure > SDK Manager)
2. 安装最新版Android SDK和Build Tools
3. 安装对应API级别的平台工具

二、小米专用SDK集成

1. 添加小米Maven仓库

在项目级build.gradle中添加：

allprojects {
    repositories {
        maven { url 'https://maven.mi.com/nexus/content/repositories/releases/' }
    }
}

2. 添加小米SDK依赖

在app模块的build.gradle中添加：

dependencies {
    // 小米推送SDK
    implementation 'com.xiaomi.mipush:sdk:3.0.3'
    
    // 小米账号登录SDK
    implementation 'com.xiaomi.account:oauth-android:latest.release'
    
    // 小米设备能力SDK
    implementation 'com.xiaomi.device:device-sdk:1.0.1'
}

三、小米开发者平台配置

1. 注册小米开发者账号：
   https://dev.mi.com/console/

2. 创建应用并获取：

   • AppID
   • AppKey
   • 推送服务证书

3. 配置应用签名：

   keytool -genkey -v -keystore mi_app_key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias mi_app_alias
   

四、设备连接与调试

1. 小米手机开发者设置

1. 进入"设置" > “关于手机”
2. 连续点击"MIUI版本"7次激活开发者模式
3. 返回进入"更多设置" > “开发者选项”
4. 开启：
   • USB调试
   • USB安装
   • USB调试（安全设置）

2. ADB连接配置

# 查看连接设备
adb devices

# 如果没有显示设备，添加udev规则
sudo tee /etc/udev/rules.d/51-android.rules <<EOF
SUBSYSTEM=="usb", ATTR{idVendor}=="2717", MODE="0666"
EOF

sudo udevadm control --reload-rules

五、核心功能实现示例

1. 初始化小米推送

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        
        // 初始化小米推送
        MiPushClient.registerPush(this, "YOUR_APP_ID", "YOUR_APP_KEY");
        
        // 设置日志级别
        LoggerInterface newLogger = new LoggerInterface() {
            @Override
            public void setTag(String tag) {}
            
            @Override
            public void log(String content, Throwable t) {
                Log.d("MiPush", content, t);
            }
        };
        MiPushClient.setLogger(this, newLogger);
    }
}

2. 小米账号登录集成

public void loginWithMiAccount(Activity activity) {
    XiaomiOAuthFuture<Bundle> future = new XiaomiOAuthorize()
        .setAppId(YOUR_APP_ID)
        .setRedirectUrl(YOUR_REDIRECT_URL)
        .setScope("openid profile")
        .setKeepCookies(true)
        .startGetAccessToken(activity);
    
    try {
        Bundle result = future.getResult();
        String accessToken = result.getString("access_token");
        // 处理登录结果
    } catch (Exception e) {
        e.printStackTrace();
    }
}

六、MIUI特性适配

1. 处理后台限制

// 检查电池优化设置
public static boolean isIgnoringBatteryOptimizations(Context context) {
    if (Build.MANUFACTURER.equalsIgnoreCase("Xiaomi")) {
        PowerManager pm = (PowerManager) context.getSystemService(Context.POWER_SERVICE);
        return pm.isIgnoringBatteryOptimizations(context.getPackageName());
    }
    return true;
}

// 引导用户关闭优化
public static void requestIgnoreBatteryOptimizations(Activity activity) {
    if (Build.MANUFACTURER.equalsIgnoreCase("Xiaomi")) {
        try {
            Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
            intent.setData(Uri.parse("package:" + activity.getPackageName()));
            activity.startActivity(intent);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2. 适配MIUI权限系统

// 检查悬浮窗权限
public static boolean hasOverlayPermission(Context context) {
    if (Build.MANUFACTURER.equalsIgnoreCase("Xiaomi")) {
        return Settings.canDrawOverlays(context);
    }
    return true;
}

// 请求悬浮窗权限
public static void requestOverlayPermission(Activity activity, int requestCode) {
    if (Build.MANUFACTURER.equalsIgnoreCase("Xiaomi")) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
            Uri.parse("package:" + activity.getPackageName()));
        activity.startActivityForResult(intent, requestCode);
    }
}

七、调试与测试建议

1. 真机测试：务必在小米真机上进行全面测试
2. MIUI版本覆盖：测试不同MIUI版本(特别是开发版和稳定版)
3. 推送测试：

   // 手动测试推送
   MiPushClient.subscribe(activity, "test_topic", null);
   MiPushClient.setAlias(activity, "test_alias", null);
   

4. 后台保活：验证应用在后台长时间运行的表现

八、发布准备

1. 在小米开发者平台提交应用审核
2. 准备MIUI适配说明文档
3. 测试各种小米机型兼容性
4. 获取小米应用商店的推广资源

通过以上步骤，您可以完整搭建小米手机App开发环境，充分利用小米设备的特有功能和MIUI系统特性，开发出体验更佳的小米专属应用。