企业内部应用分发操作指引更新时间: 2024-12-02 19:56:00

本文档介绍了通过非公开上架、认证分发两种方式发布企业内部应用的完整流程,您可按照文档内容指引进行企业内部应用创建与发布。

一、非公开上架

1、创建应用包名

1.1 操作步骤

创建应用前,创建应用前,您需要准备好应用的包名和名称,应用创建数量上限默认为15个。以下是具体步骤:

①登录并前往小米澎湃OS开发者平台,选择企业内部应用菜单栏,点击“创建应用”按钮,即可开始企业内部应用首次创建。

②点击创建应用后,您需要填写应用名称与应用包名信息

1.2 填写指南

字段释义填写规范
应用的通用名称,创建后不可修改,该名称用于应用的长期管理,在应用发布时可修改实际安装后的展示名称不超过30个字符
对于应用的唯一标识,在创建过程中如果出现包名被占用提示且您确实有此包名的所有权资质,请按照引导进行应用认领操作应用包名仅可以包含大写或小写字母(从“A”到“Z”)、数字和下划线(“_”)。包名内容中各个部分只能以字母开头,并使用“.”分割,至少包含两段内容;例如 com.android.demo

2、完善应用资料

应用创建成功后,会自动跳转至完善资料页面; 您也可以稍后在企业内部应用 - 应用列表中,找到对应应用,点击进入应用概览页;

在应用详情页中点击“发布应用”按钮继续发布流程。

2.1 上传包体

您需要针对您的应用准备.apk格式的安装包用于上传,我们将自动为您解析安装包内声明的信息,请您务必仔细核对。

①请根据您安装包的设备CPU支持场景,选择上传方式;目前小米开放平台支持“单包上传”与“双包上传”两种方式,另外针对CPU的适配声明,由于谷歌的官方要求以及高通处理器的后续迭代趋势,请务必保证包体内声明ARM架构的CPU适配说明。此部分另请参见 32/64分包上传说明

  • 单包上传:支持上传64位安装包或32/64位兼容包
  • 双包上传:需同时上传32位和64位两个安装包

另外,为了减少包体大小,提升用户体验,我们推荐您进行32/64双包上传,如果您只有兼容包体或64位包体,也可以正常提交上传。
②点击“点击上传APK”按钮选择对应的APK安装包上传,确保安装包内的包名与创建应用的包名一致。上传完成后我们将自动解析您安装包内的各项信息,如果您包体较大,请耐心等待解析完成;解析完成后,请检查各项解析字段是否正确。

字段规范参照

字段名称字段释义通过规则
CPU适配针对包体内声明的ARM架构内容判断- 单包上传:需上传32/64兼容包或64位包体 - 双包上传:两种CPU支持场景包体均在指定位置上传
大小包体实际大小尚未做大小限制,大包体的上传速度可能较慢,请耐心等待
版本名称在应用商店展示给用户的版本名称,对应包体中的versionName字段/
版本号表示此APK的版本大小,故本质上是一个数字,对应包体中的versionCode字段版本号需大于等于在架版本的版本号
targetSdk版本对应包体中的targetSdkverison字段targetSdk版本需大于等于在架版本

2.2 权限信息

权限信息部分将会在APK上传完成后进行解析,此处仅供开发者进行核对,我们将应用权限区分为敏感权限与非敏感权限,请开发者根据实际情况进行核对获取权限的必要性,以免影响后续审核。

2.3 发布设置

在发布设置部分中,您可以配置应用发布的相关内容,包括上线时间,具体如下:

字段名称填写指南
兼容设备应用的实际分发场景,默认选择手机和平板
上线时间提供“审核通过后立即上线”和“定时上线”功能 审核通过后立即上线:在人工审核通过后,此应用会在应用商店立即上架供用户下载 定时上线:您可以指定希望的上线时间点,若实际审核通过时间晚于设定时间,则会在审核通过后立即上线

2.4 展示信息

在展示信息部分中,您可以配置应用在商店内基础展示信息与截图、视频等多媒体信息。

基础信息

字段名称填写指南
应用名称可填写应用主标题与副标题,其中应用主标题内容须与软著中的名称保持一致;主标题与副标题总计不超过30个英文字符,1个中文字符算2个英文字符 应用主标题:需与软著上的名称保持一致,更新时修改需提供新名称的软著或软著变更证明 应用副标题:用于运营宣传或者进一步说明的内容
应用图标需上传 512*512px的png格式图标,图标内容需与应用安装完成后展示在手机桌面上的图标一致; 我们提供“APK解析图标”功能,用户可点击此处预览我们针对APK包体的解析结果用于对照上传图标的内容
版本名称自动读取APK包体中的versionName字段,不可修改,用于开发者自行对照
应用介绍您需针对应用的功能和亮点,用一段文字简单描述,字数在20~4000之间
应用分类您可根据应用的实际业务场景,勾选相符合的分类;若勾选其他,可自行填写相关分类描述,不超过20个字符
用户群体您可根据应用的实际业务场景,勾选相符合的用户群体;若勾选其他,可自行填写相关用户群体的描述,不超过20个字符
隐私政策(URL)您可选择填写应用中的隐私政策完整网址,已http或https开头
测试账号如果应用需要注册账号才能使用,可提供用于测试的账号和密码, 若没有测试账号且应用无法正常使用,可能会被驳回

填写指南

字段名称填写指南
截图方向根据您应用的情况选择截图方向,包括横向截图和竖向截图
应用介绍截图 - 手机您需上传至少4张截图,至多5张截图,并确保截图内容与实际应用功能相符,且不能使用重复图片 图片格式要求如下: 1. 横向截图:分辨率 1080 * 1920px,png格式,文件大小要求不超过5MB 2. 竖向截图:分辨率 1920 * 1080px,png格式,文件大小要求不超过5MB

2.5 所属权信息

您需先下载APK空包,将您要发布的应用签名打在空包内再进行上传,来证明您是该款应用的所有者。
签名获取方法
在Android平台发布应用程序之前,必须经过一个签名流程。签名就是这款应用的身份证明。下面将详细介绍签名的获取方法。
① jarsigner签名方法
您可以使用JDK自带的jarsigner工具来完成签名。jarsigner工具的命令格式如下:
jarsigner -verbose -keystore [您的私钥存放路径]-signedjar [签名后文件存放路径] [未签名的文件路径] [您的证书名称]
#jarsigner的参数说明:keystore 参数指定您的私钥的绝对路径,例如:c:\mykeystore -signedjar 参数指定签名后apk文件存放绝对的路径,例如 c:\signed.apk [未签名的文件路径] 指定要签名apk文件的绝对路径,也就是您从我们这里下载到的,例如 c:\unsigned.apk [您的证书名称] 是指您创建密钥时,您设置的证书名称。
②Linux和Mac OS X平台的签名方法
打开Terminal 程序 进入从小米开发者站下载到的verification.zip 解压后的目录,例如cd ~/Downloads/verification 使用jarsigner签名命令示例:jarsigner -verbose -keystore~/Workspace/mykeystore -signedjar ./signed.apk ./unsigned.apk xiaomi
③Windows平台签名方法
打开 “命令提示符” 程序进入从小米开发者站下载到的verification.zip解压后的目录,例如cd C:\Downloads\verification
使用jarsigner签名命令示例:jarsigner -verbose -keystoreC:\Downloads\verification\mykeystore -signedjar signed.apk unsigned.apk xiaomi
以上签名办法的获取,请在研发人员的协助下完成。

2.6 填写联系人信息

字段名称填写指南
联系人姓名请填写应用相关联系人的姓名
职务信息请填写联系人在贵公司中的职务,例如产品经理、研发负责人等
联系人邮箱请填写联系人邮箱,应用状态发生变动时,可通过此邮箱收到相关邮件
联系人手机请填写联系人的手机号,在应用遇到相关问题时,我们会有限使用此号码联系到您
验证码/

3、提交审核

我们将会在1~3个工作日内完成审核,推荐您关注应用商店开发者服务公众号。

4、获取统一链接

审核通过后,即可获取用于分发的统一链接,详情见统一链接服务(OneLink)操作指南

二、认证分发

1、绑定入口

登录并前往小米澎湃OS开发者平台,选择企业内部应用菜单,切换到认证分发页面,点击“绑定应用”按钮,即可开始应用首次绑定,绑定数量上限默认为5个。

2、填写应用信息

2.1 应用名称和应用包名

字段名称字段释义填写规范
应用名称应用的通用名称,创建后不可修改,该名称用于应用的长期管理不超过30个字符
应用包名对于应用的唯一标识,在创建过程中如果出现包名被占用提示且您确实有此包名的所有权资质,请按照引导进行应用认领操作应用包名仅可以包含大写或小写字母(从“A”到“Z”)、数字和下划线(“_”)。包名内容中各个部分只能以字母开头,并使用“.”分割,至少包含两段内容;例如 com.android.demo

2.2 签名MD5

您需填写给包体进行签名的证书MD5值,签名MD5是对签名证书计算得到的MD5值,用来校验认证分发的应用归属,Java语言的解析获取方法如下:
设置参数

需将KEYSTORE_PATH、KEY_ALIAS、PASSWORD参数设置为包体签名的证书信息后,运行并输出则获取得到该证书的签名MD5
具体代码

import java.io.FileInputStream;
import java.io.InputStream;
import java.security.KeyStore;
import java.security.KeyStoreException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.security.cert.Certificate;

public class GetCertKeyMd5 {
private static final String KEYSTORE_PATH = "/home/mi/Downloads/test.jks"; // 证书路径
private static final String KEY_ALIAS = "key0"; // 证书别名
private static final String PASSWORD = "123456"; // 证书密码

public static void main(String[] args) throws KeyStoreException {
// 创建KeyStore实例
KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());

// 加载keystore文件
try (InputStream inputStream = new FileInputStream(KEYSTORE_PATH)) {
keyStore.load(inputStream, PASSWORD.toCharArray());
Certificate cert = keyStore.getCertificate(KEY_ALIAS);
System.out.println(md5(toHexString(cert.getEncoded()).getBytes()));
} catch (Exception e) {
throw new RuntimeException(e);
}
}

public static String toHexString(byte[] bytes) {
StringBuilder hexString = new StringBuilder();
for (byte b : bytes) {
String hex = Integer.toHexString(0xFF & b);
if (hex.length() == 1) {
hexString.append('0');
}
hexString.append(hex);
}
return hexString.toString();
}

private static String md5(byte[] data) throws Exception {
try {
MessageDigest md = MessageDigest.getInstance("MD5");
byte[] messageDigest = md.digest(data);
StringBuilder sb = new StringBuilder();
for (byte b : messageDigest) {
sb.append(String.format("%02x", b));
}
return sb.toString();
} catch (NoSuchAlgorithmException e) {
throw new RuntimeException(e);
}
}
}

以上签名MD5的获取,请在研发人员的协助下完成。

2.3 上传含签名的APK空包

您需先下载APK空包,将您要发布的应用签名打在空包内再进行上传,来证明您是该款应用的所有者。
签名获取方法
在Android平台发布应用程序之前,必须经过一个签名流程。签名就是这款应用的身份证明。下面将详细介绍签名的获取方法。
① jarsigner签名方法
您可以使用JDK自带的jarsigner工具来完成签名。jarsigner工具的命令格式如下:
jarsigner -verbose -keystore [您的私钥存放路径]-signedjar [签名后文件存放路径] [未签名的文件路径] [您的证书名称]
#jarsigner的参数说明:keystore 参数指定您的私钥的绝对路径,例如:c:\mykeystore -signedjar 参数指定签名后apk文件存放绝对的路径,例如 c:\signed.apk [未签名的文件路径] 指定要签名apk文件的绝对路径,也就是您从我们这里下载到的,例如 c:\unsigned.apk [您的证书名称] 是指您创建密钥时,您设置的证书名称。
②Linux和Mac OS X平台的签名方法
打开Terminal 程序 进入从小米开发者站下载到的verification.zip 解压后的目录,例如cd ~/Downloads/verification 使用jarsigner签名命令示例:jarsigner -verbose -keystore~/Workspace/mykeystore -signedjar ./signed.apk ./unsigned.apk xiaomi
③Windows平台签名方法
打开 “命令提示符” 程序进入从小米开发者站下载到的verification.zip解压后的目录,例如cd C:\Downloads\verification
使用jarsigner签名命令示例:jarsigner -verbose -keystoreC:\Downloads\verification\mykeystore -signedjar signed.apk unsigned.apk xiaomi
以上签名办法的获取,请在研发人员的协助下完成。

3、提交申请

当所有信息填写完成后,您可点击“提交申请”按钮,此应用将会进入核验流程。

我们将会在1~3个工作日内完成核验,推荐您关注应用商店开发者服务公众号。
以上为小米澎湃OS开发者平台企业内部应用分发操作指引,如有任何问题,可联系客服,与我们取得联系。