Unity从服务器下载资源并调用安卓接口实现Apk安装

一、前言

        通过Unity的UnityWebRequest类来实现从服务器下载Apk文件；在Android Studio中封装安装应用包接口，导出AAR包供Unity调用，并通过广播接收器监测应用是否安装完成，完成则删除下载的Apk文件；Unity端通过C#脚本调用AAR内部封装的接口。

二、安卓交互功能封装

1、Java类创建

（1）创建方法调用类

        此类用于创建供Unity端调用的方法，具体代码如下：

import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.net.Uri;
import android.os.Build;

import androidx.core.content.FileProvider;

import java.io.File;

public class InstallApkUtils {
    private Context mContext;
    private static InstallApkUtils mInstallApkUtils = null;
    private InitializeApkBroadcastReceiver apkBroadcastReceiver;
    public static String apkFilePath;

    public InstallApkUtils(Context context) {
        this.mContext = context;
    }

    public static InstallApkUtils getInstance(Context context){
        if (mInstallApkUtils == null) {
            mInstallApkUtils = new InstallApkUtils(context);
        }
        return mInstallApkUtils;
    }

    //安装Apk
    public void installApk(String filePath){
        apkFilePath = filePath;
        File apkFile = new File(filePath);
        if(!apkFile.exists()){
            return;
        }

        Intent intent = new Intent(Intent.ACTION_VIEW);
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);


        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.N){//安卓7.0以上
            Uri apkUri = FileProvider.getUriForFile(mContext,mContext.getPackageName() + ".fileProvider",apkFile);
            intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
            intent.setDataAndType(apkUri,"application/vnd.android.package-archive");
        }
        else {//安卓7.0以下
            intent.setDataAndType(Uri.parse("file://" + apkFile.toString()),"application/vnd.android.package-archive");
        }
        if(mContext.getPackageManager().queryIntentActivities(intent,0).size() > 0){
            mContext.startActivity(intent);
        }
    }

    //注册广播
    public void registerBroadcast(){
        if(apkBroadcastReceiver == null){
            apkBroadcastReceiver = new InitializeApkBroadcastReceiver();
        }
        IntentFilter intentFilter = new IntentFilter();
        intentFilter.addAction(Intent.ACTION_PACKAGE_ADDED);
        intentFilter.addAction(Intent.ACTION_PACKAGE_REMOVED);
        intentFilter.addAction(Intent.ACTION_PACKAGE_REPLACED);
        intentFilter.addDataScheme("package");
        mContext.registerReceiver(apkBroadcastReceiver,intentFilter);
    }

    //取消注册广播
    public void unregisterBroadcast(){
        if(apkBroadcastReceiver != null){
            mContext.unregisterReceiver(apkBroadcastReceiver);
            apkBroadcastReceiver = null;
        }
    }

    //删除apk文件
    public static void removeApkFile(String path){
        File apkFile = new File(path);
        if(apkFile.isFile() && apkFile.exists()){
            apkFile.delete();
        }
    }
}

（2）创建广播接收器

        广播接收器用于监测应用安装包是否安装完成，以便删除安装包。

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;

public class InitializeApkBroadcastReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if(Intent.ACTION_PACKAGE_ADDED.equals(intent.getAction())){
            InstallApkUtils.removeApkFile(InstallApkUtils.apkFilePath);
        }
        if(Intent.ACTION_PACKAGE_REMOVED.equals(intent.getAction())){

        }
        if(Intent.ACTION_PACKAGE_REPLACED.equals(intent.getAction())){
            
        }
    }
}

2、AndroidManifest.xml文件配置

        添加权限及配置provider节点。广播的注册不在此文件里静态注册，采用代码动态注册，因为导出的是插件包，无法有效针对应用进行注册。

（1）添加权限

<uses-permission android:name="android.permission.REPLACE_EXISTING_PACKAGE"/>
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

（2）配置provider节点

<application>
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileProvider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths"/>
    </provider>
</application>

        此处，需要保证android:authorities的值与InstallApkUtils类中的mContext.getPackageName() + ".fileProvider"的值保持一致，采用${applicationId}.fileProvider即可保证一致。

3、新建xml资源文件

        在模块-->src-->main下新建res文件路径，然后在res下新建xml文件路径，最后在xml文件夹下新建file_paths.xml文件，写入以下内容。

<?xml version="1.0" encoding="utf-8" ?>
<paths>
    <external-path
        name="apkFiles"
        path="."/>
</paths>

4、构建AAR包

        选中模块，点击Build-->Make Module，或者直接Build-->Rebuild Project。

        待编译完成后，在模块-->build-->outputs-->aar里便可找到编译好的AAR包。

三、Unity调用

1、AAR包放置

        直接将AAR包拖放至Unity的Assets-->Plugins-->Android路径下。

2、创建C#脚本，调用AAR包

（1）从服务器下载方法

using System.Collections;
using System.Collections.Generic;
using System.IO;
using UnityEngine;
using UnityEngine.Networking;
using UnityEngine.UI;

public class ApplicationStoreManager : MonoBehaviour
{
    //回调
    public delegate void DownloadCallBack();
    public delegate void DownloadCallBack<in T>(T arg);

    public Slider downloadProgressSlider;//下载进度条
    public Text downloadProgressText;//下载进度显示文本
    public Button downloadButton;//下载按钮

    // Start is called before the first frame update
    void Start()
    {
        DownloadButtonAddListener();
    }

    /// <summary>
    /// 从服务器下载文件
    /// </summary>
    /// <param name="url"> 文件地址 </param>
    /// <param name="fileName"> 文件名 </param>
    /// <param name="downloadCallBack"> 回调函数 </param>
    private void DownloadFileFromServer(string url,string fileName,DownloadCallBack<string> downloadCallBack)
    {
        UnityWebRequest request = UnityWebRequest.Get(url);
        StartCoroutine(DownloadFileFromServer(request, fileName, downloadCallBack));
    }

    /// <summary>
    /// 从服务器下载文件协程
    /// </summary>
    /// <param name="unityWebRequest"> UnityWebRequest </param>
    /// <param name="fileName"> 文件名 </param>
    /// <param name="downloadCallBack"> 回调函数 </param>
    /// <returns></returns>
    IEnumerator DownloadFileFromServer(UnityWebRequest unityWebRequest,string fileName,DownloadCallBack<string> downloadCallBack)
    {
        unityWebRequest.SendWebRequest();
        if (unityWebRequest.result == UnityWebRequest.Result.ConnectionError)
        {
            Debug.Log("Download Error:" + unityWebRequest.error);
        }
        else
        {
            //下载进度条显示
            while (!unityWebRequest.isDone)
            {
                downloadProgressSlider.value = unityWebRequest.downloadProgress;
                
                //下载进度转化为百分比数值后保留一位小数
                float progress = Mathf.Round((unityWebRequest.downloadProgress * 100f) * 10f) / 10f;
                downloadProgressText.text = progress.ToString() + "%";
                yield return 0;
            }

            if (unityWebRequest.isDone)
            {
                downloadProgressSlider.value = 1;
                downloadProgressText.text = "100%";
                byte[] results = unityWebRequest.downloadHandler.data;
                string pathUrl = Application.persistentDataPath + "/ApkFile";
                //保存文件
                SavaFile(results, pathUrl, fileName, downloadCallBack);
                //取消下载按钮事件
                downloadButton.GetComponentInChildren<Text>().text = "下载完成";
                downloadButton.onClick.RemoveAllListeners();
            }
        }
    }

    /// <summary>
    /// 保存文件
    /// </summary>
    /// <param name="results"> 下载得到的数据 </param>
    /// <param name="savePath"> 保存路径 </param>
    /// <param name="fileName"> 文件名 </param>
    /// <param name="downloadCallBack"> 回调函数 </param>
    private void SavaFile(byte[] results,string savePath,string fileName,DownloadCallBack<string> downloadCallBack)
    {
        if (!File.Exists(savePath))
        {
            Directory.CreateDirectory(savePath);
        }

        string path = savePath + "/" + fileName;
        FileInfo fileInfo = new FileInfo(path);
        Stream stream;
        stream = fileInfo.Create();
        stream.Write(results, 0, results.Length);
        stream.Close();
        stream.Dispose();
        downloadCallBack(path);
    }

    /// <summary>
    /// 下载按钮添加事件
    /// </summary>
    public void DownloadButtonAddListener()
    {
        downloadButton.onClick.AddListener(delegate ()
        {
            DownloadFileFromServer();
        });
    }

    /// <summary>
    /// 从服务器下载文件
    /// </summary>
    public void DownloadFileFromServer()
    {
        downloadButton.GetComponentInChildren<Text>().text = "下载中...";
        DownloadFileFromServer("http://IP地址及端口/Apk安装包名称.apk", "Apk安装包名称.apk", InstallApk);
    }
}

（2）安卓接口调用方法

        在以上ApplicationStoreManager脚本中增加以下内容。

using System.Collections;
using System.Collections.Generic;
using System.IO;
using UnityEngine;
using UnityEngine.Networking;
using UnityEngine.UI;

public class ApplicationStoreManager : MonoBehaviour
{
    private AndroidJavaObject installApkUtils;

    private void Awake()
    {
        AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
        AndroidJavaObject currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity");
        AndroidJavaClass installApkUtilsClass = new AndroidJavaClass("包名.InstallApkUtils");
        installApkUtils = installApkUtilsClass.CallStatic<AndroidJavaObject>("getInstance", currentActivity);
    }

    // Start is called before the first frame update
    void Start()
    {
        installApkUtils.Call("registerBroadcast");
    }

    private void OnDestroy()
    {
        installApkUtils.Call("unregisterBroadcast");
    }

    /// <summary>
    /// 安装Apk
    /// </summary>
    /// <param name="filePath"> Apk文件路径 </param>
    public void InstallApk(string filePath)
    {
        installApkUtils.Call("installApk", filePath);
    }
}

        在Start方法里注册广播接收器，在OnDestroy方法里取消注册广播接收器。InstallApk方法用于调用安装Apk方法，其作为下载完成的回调，下载完成后自动调用安装。

3、Http文件服务器

        本项目采用HFS用来创建文件服务器，来测试从网络下载文件。详见：HFS官网

        HFS下载地址：Download

        下载后只有一个exe文件，为免安装文件，将其放于合适的路径下便可。

        打开后将需要下载的文件拖放至Home内，也可以直接将整个文件保存文件夹拖入，选中要下载的文件，窗口上方显示的地址即为下载地址。 

4、Unity工程设置

        此处至关重要，不设置会导致无法使用安卓的androidx。

（1）勾选Publishing Settings内部选项

（2）修改配置文件

        勾选上以上两个选项后，会在Unity工程的Assets-->Plugins-->Android文件夹内生成gradleTemplate.properties和mainTemplate.gradle两个文件，需要分别修改这两个文件。

1）修改mainTemplate.gradle文件

        在dependencies 块中添加一行代码： implementation 'androidx.appcompat:appcompat:1.2.0’。

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.2.0'
**DEPS**}

2）修改gradleTemplate.properties文件

        在文件最后面添加以下内容：

android.overridePathCheck=true
android.useAndroidX=true
android.enableJetifier=true

5、UGUI设计

        在Unity编辑器里创建一个Button、Slider及Text，分别用来绑定下载方法、展示下载进度条及展示下载进度百分比。 

6、切换至安卓平台，打包apk，安装测试便可

四、AAR包资源下载入口

        如果有小伙伴看了以上教程还不知道如何使用，可以直接下载以下AAR包直接使用，里面有插件的包名，替换掉ApplicationStoreManager脚本里的“包名”便可。

        安卓端安装Apk及安装完成回调AAR插件包