uni-app本地离线打包应用配置

矫情吗；* 2024-03-27 16:52 54阅读 0赞

### 1.配置应用版本号 ###

![在这里插入图片描述][84c099ba0ec54c778b13c1e903a8c3dc.png]

*  versionCode为应用的版本号（整数值），用于各应用市场的升级判断，建议与manifest.json中version ->  
    code值一致
 *  versionName为应用的版本名称（字符串），在系统应用管理程序中显示的版本号，建议与manifest.json中version ->  
    name值一致。
 *  applicationId为应用的包名，一般设置为反向域名，不建议修改。
 *  建议将targetSdkVersion设置为25或以上。
 *  App离线SDK minSdkVersion最低支持21，小于21在部分5.0以下机型上将无法正常使用。

**完整版build.gradle可参考如下内容。**

apply plugin: 'com.android.application'
    
    android {
        
    	compileSdkVersion 29
    	defaultConfig {
        
    		applicationId "com.example.myapplication"
    		minSdkVersion 21
    		targetSdkVersion 28
    		versionCode 1
    		versionName "1.0"
    		multiDexEnabled true
    		ndk {
        
    			abiFilters 'x86', 'armeabi-v7a', 'arm64-v8a'
    		}
    	}
    	compileOptions {
        
    		sourceCompatibility JavaVersion.VERSION_1_8
    		targetCompatibility JavaVersion.VERSION_1_8
    	}
    	buildTypes {
        
    		release {
        
    			minifyEnabled false
    			proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    		}
    	}
    }
    
    dependencies {
        
    	implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: [])
    	implementation 'androidx.appcompat:appcompat:1.0.0'
    	implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    	implementation 'com.alibaba:fastjson:1.2.83'
    	implementation 'androidx.webkit:webkit:1.3.0'
    }

### 2.配置应用名称 ###

打开app-> src -> main -> res -> values -> strings.xml文件，修改“app\_name”字段值，该值为安装到手机上桌面显示的应用名称，建议与manifest.json中name（基础配置中的应用名称）对应。

配置应用启动页及provider节点  
将下述activity信息添加到Androidmanifest.xml的application节点中

注意：新建的项目默认会有一个MainActivity的节点，必须删掉！

注意：为适配折叠屏，需要在PandoraEntryActivity的android:configChanges属性中追加“smallestScreenSize|screenLayout|screenSize”，参考如下配置。

注意：为适配暗黑模式，需要在PandoraEntryActivity的android:configChanges属性中追加“uiMode”，参考如下配置。

### 3.配置应用启动页及provider节点 ###

添加provider信息到Androidmanifest.xml的application节点中

**注意：3.3.7及以上版本，可以不添加**

<provider
        android:name="io.dcloud.common.util.DCloud_FileProvider"
        android:authorities="${apk.applicationId}.dc.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/dcloud_file_provider" />
    </provider>

**注意：$\{apk.applicationId\} 必须替换成当前应用的包名**

如果集成离线SDK时需要重写application，必须继承自DCloudApplication，否则会导致SDK中业务逻辑无法正常运行。

将对应的application配置到Androidmanifest.xml中（如下），并添加tools:replace="android:name"以防出现冲突。

### 4.配置应用图标和启动界面 ###

图标名称

icon.png为应用的图标。

push.png为推送消息的图标。

splash.png为应用启动页的图标。

将icon.png、push.png、splash.png放置到drawable，drawable-ldpi，drawable-mdpi，drawable-hdpi，drawable-xhdpi，drawable-xxhdpi文件夹下，不同文件夹下对应不同图片尺寸，可[参考文档][Link 1]

![在这里插入图片描述][190a1ce8011f43da8eadc7447ff68288.png]  
修改Androidmanifest.xml中application节点的icon属性为@drawable/icon。如下图：

![在这里插入图片描述][67e380326c9f42fa9751dc904f5c3f86.png]  
注意：splash.png在不同设备上显示效果不一样，为防止出现拉伸的状况，建议使用Android studio生成.9.png类型图片，可[参考文档][Link 2]

[84c099ba0ec54c778b13c1e903a8c3dc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/a24762a32f0746a99b6eee95c92d4ae5.png
[Link 1]: https://blog.csdn.net/xuaho0907/article/details/72848520
[190a1ce8011f43da8eadc7447ff68288.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/e1a95744e85b443b93852987aa6a7dac.png
[67e380326c9f42fa9751dc904f5c3f86.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/5fff734e1a0c41529f69e2993956be92.png
[Link 2]: https://ask.dcloud.net.cn/article/35527