!!!"#$%&'()*+,-./0)10/12345'6789:;<=>?78:@A>?BC'!"#$%&'()*+,-./.0123-用户手册1/33版权©2024用友集团版权所有。未经用友集团的书面许可，本用户手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本用户手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本用户手册的内容并不代表用友网络所做的承诺。用户手册2/33目录第一章总体概述...............................................................................................................................................41.1产品概述...............................................................................................................................................41.2产品价值...............................................................................................................................................41.3应用场景...............................................................................................................................................51.3.1场景一：移动APP开发...............................................................................51.3.2场景二：企业定制移动工作台...................................................................61.4初始准备...............................................................................................................................................8第二章操作指南...............................................................................................................................................82.1移动APP开发.....................................................................................................................................82.1.1功能描述............................................................................................................82.1.2业务规则............................................................................................................82.1.3栏目说明............................................................................................................92.1.4操作说明............................................................................................................92.2移动插件库.......................................................................................................................................222.2.1功能描述.........................................................................................................222.2.2业务规则.........................................................................................................222.2.3栏目说明.........................................................................................................222.2.4操作说明.........................................................................................................232.3APP证书管理...................................................................................................................................242.3.1功能描述.........................................................................................................24用户手册3/332.3.2业务规则.........................................................................................................252.3.3栏目说明.........................................................................................................252.3.4操作说明.........................................................................................................252.4APP版本管理...................................................................................................................................272.4.1功能描述.........................................................................................................272.4.2业务规则.........................................................................................................282.4.3栏目说明.........................................................................................................282.4.4操作说明.........................................................................................................282.5APP统计分析...................................................................................................................................302.5.1功能描述.........................................................................................................302.5.2业务规则.........................................................................................................302.5.3栏目说明.........................................................................................................302.5.4操作说明.........................................................................................................31用户手册4/33第一章总体概述1.1产品概述移动开发服务为企业移动应用开发提供了专业的低代码开发模式，采用自主研发的跨端引擎技术，前端使用H5和JavaScript作为开发语言，统一端API标准，通过模块化组装，一次开发实现跨平台IOS、Android、H5和小程序的移动应用开发，同时支持从开发、调试、发布、管理到运营的全生命周期管理。移动开发服务提供移动APP开发、定制移动工作台、移动插件库、APP证书管理、APP版本管理等功能，支持按角色划分不同权限，以助力企业开展移动端开发及运营的相关工作。移动开发服务应用架构图1.2产品价值•前端使用H5和JavaScript作为开发语言，一次开发实现跨平台IOS、Android、H5和小程序的移动应用开发；•提供1000+移动插件能力，可通过模块化搭建快速满足企业移动业务需求；用户手册5/33•支持企业对APP版本的管理和更新，其中包括版本更新和云修复，版本更新支持对历史版本进行强制更新、强制关闭。云修复又叫热更新，Android/iOS平台的APP修复功能,无需提交新版本到应用市场,对指定版本进行修复或根据不同用户渠道范围修复；•提供APP运营数据支持，统计分析包括应用数据、版本数据、终端数据、错误报告的统计分析能力；•运营配置提供闪屏广告、隐私协议的通用能力，无需开发，配置后直接生效使用。1.3应用场景1.3.1场景一：移动APP开发1.3.1.1业务描述企业基于业务开发自定义移动APP，一套代码快速生成Android和iOSApp、HTML5等多端高性能原生应用。1.3.1.2业务流程流程说明：•创建自定义移动应用，在端设置中进行通用配置及应用可见性配置；•APP证书中创建或上传证书；•在YonStudio开发工具中进行编码工作，编码完成后进入代码上传配置上传方式；用户手册6/33•进入移动插件进行插件管理、添加插件、上传自定义插件等操作；•上述开发流程完成后进入移动打包，根据业务需求对打包配置进行选择和打包；•在运营管理中对APP版本进行管理，查看APP的运营统计数据，APP闪屏广告和隐私协议相关配置。1.3.1.3应用清单•移动APP开发•定制移动工作台•移动插件库•APP证书管理•APP版本管理•APP统计分析•APP门户配置1.3.2场景二：企业定制移动工作台1.3.2.1.1业务描述定制移动工作台将友空间私有版APP应用模版作为企业移动工作入口方案，帮助企业实现高效协同办公。友空间私有版APP包含工作台、通讯录、我的、消息四个核心模块，满足企业灵活定制自己专属的移动工作台APP。友空间私有版APP专属打包只需通过简单配置就可以打包生成自己专属的移动入口APP/小程序安装包；用户手册7/331.3.2.1.2业务流程流程说明：•创建定制移动工作台应用，进入端设置完善通用配置、移动工作台开发配置信息；•APP证书中创建或上传证书；•定制移动工作台一般使用默认版本，如有定制版本则在代码上传中上传为租户提供的单独的代码包；•进入移动插件进行插件管理、添加插件、上传自定义插件等操作；•上述开发流程完成后进入移动打包，根据业务需求对打包配置进行选择和打包；•在运营管理中对APP版本进行管理，查看APP的运营统计数据，APP运营配置进行相关配置。1.3.2.1.3应用清单•移动APP开发•定制移动工作台•移动插件库•APP证书管理•APP版本管理•APP统计分析用户手册8/33•APP门户配置1.4初始准备环境及产品规格开通。第二章操作指南2.1移动APP开发2.1.1功能描述移动APP开发是为开发人员提供的一种专业的移动应用开发模式，采用自主研发的跨端引擎技术，前端使用H5和JavaScript作为开发语言，统一端API标准，通过模块化组装，一次开发就能完成跨平台IOS、Android、H5和小程序的移动应用生成，同时支持从开发、调试、发布、管理到运营的全生命周期管理。2.1.2业务规则•端设置：应用通用配置及维护，包括应用图标、横竖屏设置、状态栏设置、启动页、应用可见性设置；•APP证书：Android和iOS证书创建、管理；•代码上传：应用的代码提交方式管理，支持代码包、git两种方式，也支持基于在线应用网址进行打包；•移动插件：提供数百个移动插件供应用选择，自定义插件创建和管理，基于自定义loader进行移动真机调试；•移动打包：通过简单配置，一键云端打包生成APP、小程序、H5轻应用、原生SDK四种类型的应用，提供应用程序包的下载和管理；•运营管理：应用的版本管理、统计分析、运营配置。用户手册9/332.1.3栏目说明栏目名称说明应用名称新建应用的名称应用可见性设置应用需打开其他APP应用时,需要提前进行配置，以便系统可以检测设备是否安装对应APP应用。.KeystoreAndroid系统的应用证书文件后缀名.p12iOS系统的应用证书文件后缀名.mobileprovisioniOS应用证书生成的描述文件后缀名2.1.4操作说明2.1.4.1应用管理移动APP开发支持创建和管理自定义移动应用，平台提供多个应用前端模版，上百款原生插件和组件，可以帮助开发者大大降低专业代码开发的工作量。开发者可以通过H5和AVM两种开发语言进行开发，通过H5开发可以快速完成Android&iOSAPP、SDK、友空间小程序类型的应用；基于AVM多端开发模式可以生成原生APP、小程序、H5轻应用、原生SDK四种类型的应用。用户手册10/332.1.4.2应用概览应用概览是当前应用的总体情况的视图展现，包括应用的基本信息，核心运营数据展示，开发工具的下载、开发流程的进度展示，近期代码、打包、版本相关的操作记录，以及应用协作成员的列表。通过操作卡片可直接进入对应功能节点，为用户开发管理提供便捷操作。用户手册11/332.1.4.3端设置端设置提供应用的通用配置能力，可为应用配置图标、启动页，也可基于业务场景设置应用横竖屏以及状态栏显示状态，同时提供应用可见性配置，通过可视化的配置界面降低应用开发门槛。1.通用配置如下图所示，通用设置包含对当前应用的图标上传、横竖屏设置、状态栏设置、版本更新开关、云修复开关、启动页上传以及应用可见性配置功能。用户手册12/33•图标：APP应用上架应用市场以及安装到设备时显示的应用图标。•启动页：分为10801920、15362048、11252436三种，其中10801920为必填项，其余设备机型分辨率系统将进行自动适配。•版本更新/云修复开关：开关开启后，打包前系统会自动将相关配置信息添加至config.xml中，以保证版本更新/云修复功能的正常使用。•统计分析/闪屏广告开关：开启后，打包的APP版本将支持使用统计分析及闪屏广告服务。•应用可见性设置：提供PackageName、Intent、Provider三种方式进行配置，当前应用需打开其他APP应用时,需要提前进行配置，以便手机系统可以检测设备当前是否安装对应APP应用。2.1.4.4APP证书APP证书提供应用的证书管理能力，可通过APP证书对当前应用的证书进行上传、编辑、自动创建，满足开发者对于APP应用证书维护的需求。用户手册13/331.Android证书：•上传证书：文件限制为.keystore，证书上传成功后证书库密码及证书密码支持填写。•自动创建证书：有效期默认100年，必填项为应用包名、证书别名、证书库密码、证书密码，证书创建成功后将自动填充至Android证书一栏，支持替换。2.iOS证书：证书分为p12证书和描述文件（测试证书和正式证书均需单独上传），上传时文件类型分别限制为.p12和.mobileprovision。2.1.4.5代码上传平台支持多种代码维护方式，打包时将根据上传代码包或Git地址拉取代码进行打包；为了方便webapp打包，也支持基于在线应用网址的打包方式。用户手册14/331.Git平台：目前只支持设置以下Git平台：码云：gitee.com；阿里云云效：codeup.aliyun.com；腾讯云coding：e.coding.net；极狐Gitlab：jihulab.com；腾讯云-工蜂源码：git.code.tencent.com。2.代码包：将应用源码压缩为zip包进行上传，zip包需遵循widget目录结构。3.网址：支持将网址打包为App安装包。（注：此类安装包只适合线下分发，不适合上架到应用市场）2.1.4.5.1移动插件移动插件提供系统插件集成和自定义插件集成功能，平台提供了丰富的官方插件和生态插件供开发者使用，在移动插件中添加对应插件并进行相关配置即可集成该插件的功能到应用中。1.已添加插件已添加插件中显示当前应用已添加的插件，支持对插件进行集成配置和移除。用户手册15/33•应用创建成功后，在已添加插件中默认显示mam预置插件，此插件关联版本更新、云修复、统计分析服务的功能使用。•每次打包时，默认使用上一次的插件版本，支持开发者修改插件版本，如勾选始终使用插件新版本，那么每次打包自动更新为插件最新版本。如修改插件版本，建议开发者详细验证应用的相关关联功能，避免应用出现bug。•部分插件需要对其完善配置项信息，该类型插件在添加后会在已添加插件的插件卡片上显示配置按钮，完善配置信息后插件方可正常使用（也可通过config.xml进行配置）。2.移动插件库移动插件库提供所有官方插件、生态插件供开发者选择，支持按插件分类和插件名称进行检索，同时支持按移动设备系统进行筛选。用户手册16/333.自定义插件当官方插件无法满足想要开发的功能时，可通过封装自定义插件的方式进行集成。自定义插件列表中显示当前租户的用户上传的自定义插件，可以对自定义插件进行管理。•自定义插件上传成功后，不会自动添加至当前应用，需要在应用中进行手动添加。用户手册17/332.1.4.5.2移动打包移动打包提供应用打包服务，完成必要的前置工作后支持将应用进行打包，发布至各个平台。1.打包设置打包设置用于开发者对本次的开发成果进行打包前配置，支持APP权限配置、选择包类型、APP全局加密、设置版本号等功能。•自定义移动应用（使用AVM开发）：支持APP、小程序、H5、SDK、Loader调试器打包。其中APP支持iOS、Android；小程序支持微信小程序、钉钉小程序、友空间小程序；H5轻应用支持微信公众号、企微公众号、钉钉H5微应用、通用H5；原生SDK支持iOS、Android；Loader调试器支持iOS、Android。•自定义移动应用（不使用AVM开发）：支持APP、SDK、Loader调试器打包。•Android支持APK和ABB两种安装包格式，iOS支持iphone和ipad两种类型。APP分为测试包和正式包，APP测试包只有7天有效期。APP以外的其他类型无测试和正式包的区分。用户手册18/33•APP权限设置：支持选择应用中使用到的系统权限，比如电话、通讯录、短信等相关隐私权限的设置•APP设置支持调试类型、代码加密、版本号等相关设置。•高级设置：支持选择应用引擎版本、代码压缩、固件要求。2.打包记录•Android&iOS提供二维码和安装包两种获取方式，通过二维码可直接安装到终端设备上，iOS的包如果使用企业证书可支持安装，如果是普通证书需要针对iOS证书添加UDID后才能在指定手机上安装测试。•Android应用打包后生成的二维码有效期为2小时，过期后需要刷新重新获取。•小程序安装包支持下载后，发布到指定三方平台。（友空间、微信、钉钉）•H5代码包下载后，需要部署到服务器后才可运行。•SDK下载后，需要开发集成到其他原生APP中才能使用。2.1.4.5.3运营管理提供针对APP所需的版本更新、统计分析、闪屏广告及隐私条款等完整的运营管理功能。1）版本管理用户手册19/33版本管理提供版本更新和云修复能力，版本更新支持Android和iOS版本的同步或异步管理。云修复提供可在应用内进行更新，无需再次提交应用市场，使版本迭代更加高效。1.版本更新•平台支持选择Android和iOS。•更新地址请勿填写打包后生成的下载地址，可以填写自己服务器生成的下载地址或应用市场的下载地址。•版本将根据Android或iOS打包的正式版版本号进行选择和展示。•强制更新：在版本更新记录中关闭较低版本的记录，即表示只能下载新版本才能继续使用。•强制关闭：当版本更新记录中所有版本均已关闭后，即表示当前应用不再运营，应用启动后将强制关闭。2.云修复用户手册20/33•云修复是指定版本进行修复的，提交更新前需要选择修复的版本。•云修复支持静默修复和提示修复，选择静默修复，下次重启应用时自动生效，选择提示修复会显示弹出框提示用户下载更新包，重启APP。2）统计分析统计分析提供多维度APP运营数据汇总，方便运营人员了解运营情况。•只有APP正式包打包并安装后才会产生统计数据。•数据筛选最大筛选范围为1个月。用户手册21/333）运营配置1.运营配置目前提供应用闪屏广告和隐私协议配置，可通过此功能对闪屏广告进行上传，支持设置显示时间（3-6秒）。•启用闪屏广告并上传闪屏广告后，“端设置”中设置的启动页将不再生效。•1080/1920分辨率为必填项，1536/2048分辨率和1125*2436分辨率为选填项。2.隐私协议配置提供APP应用隐私协议的设置及维护功能，隐私协议配置提供配置模式和代码模式两种方式，用户无需再对隐私协议功能进行单独开发。用户手册22/33•配置模式适用于不具备开发能力的运营人员，通过配置模式可直接对应用的协议进行维护和更新。配置模式下，默认显示隐私条款和用户协议的配置项，最多支持新增3个协议配置项对协议名称和内容进行完善；•代码模式适用于具备开发能力的开发人员，通过改造代码模式中提供的模版可自定义隐私协议在应用中的展示样式、协议内容等。2.2移动插件库2.2.1功能描述移动插件库涵盖移动开发90%以上场景所需的设备访问、功能扩展、开放SDK等原生插件，平台有完善统一的插件扩展规范，目前已提供数百个通用官方系统原生插件和生态插件，同时支持企业可根据需求自定义扩展移动应用的原生能力。2.2.2业务规则•移动插件库：展示移动原生插件，包括插件分类筛选和名称查询结果展示；•自定义插件：租户级自定义插件管理，支持自定义插件的上传、更新、删除及SDK下载。2.2.3栏目说明用户手册23/33栏目名称说明插件名称移动插件的名称支持系统移动插件所支持的手机系统版本号移动原生插件或自定义插件的版本编号自定义插件SDK开发自定义插件使用的模版2.2.4操作说明2.2.4.1移动插件库移动插件库提供移动插件的展示和查询服务，可根据插件分类、插件名称、插件支持系统进行插件查询；同时提供自定义插件管理，为企业扩展移动原生能力提供基础。1）移动插件列表如下图所示，移动插件列表中包含所有移动原生插件资源，支持按名称搜索、按分类和支持系统筛选、翻页等功能。移动插件：分为iOS和Android版，官方提供了大部分场景所需的原生插件，支撑开发者快速实现项目所需的相关原生能力；筛选：基于插件的一级分类和二级分类显示对应插件筛选结果；用户手册24/33名称：支持插件名称模糊查询功能;系统筛选：提供插件支持系统筛选功能。2）自定义插件管理如下图所示，自定义插件列表中展示当前租户下上传的所有自定义插件，可对插件进行上传、更新、下载文档、删除操作。上传：插件分为iOS和Android版，插件名称不能与系统插件重名，iOS或Android版插件包至少上传1个，且文件名需与插件名称保持一致；更新：不支持修改插件名称、中文名称、插件描述；删除：已被添加至应用的自定义插件不支持删除，将插件从应用中移出后允许删除。2.3APP证书管理2.3.1功能描述用户手册25/33APP证书管理提供租户级Andriod和iOSAPP证书上传、更新、下载和删除的功能，自动同步租户下各应用中上传或生成的证书。2.3.2业务规则•Android证书管理：支持证书上传、删除、证书文件名称及别名搜索；•iOS证书管理：支持p12证书及描述文件上传、删除、证书文件名称及别名搜索。2.3.3栏目说明栏目名称说明.keystoneAndroid系统证书文件格式.p12iOS系统证书文件格式.mobileprovisioniOS系统描述文件格式2.3.4操作说明2.3.4.1APP证书APP证书提供Android和iOS证书管理服务，租户内成员可将证书统一上传至此处进行管理；同时系统也支持将应用内所上传或生成的证书自动同步至此服务。1）Android证书管理如下图所示，Android证书列表中展示所有上传和自动同步的证书，显示证书名称、证书别名、应用包名。用户手册26/33•添加证书文件：添加Android证书时，应用包名、证书别名、证书库密码、证书密码及证书文件均为必填项；•删除证书文件：未绑定应用的证书可正常删除，已绑定应用的证书删除时会提示绑定的应用。2）iOS证书管理如下图所示，iOS分为P12证书和描述文件，为一对多的关系，即一个P12证书对应多个描述文件，iOS证书管理中也遵循此逻辑，用户需先上传P12证书，再选择P12证书上传对应的描述文件。用户手册27/33单应用的APP证书会同步到APP证书管理，同时也支持应用证书从租户的APP证书库中选择资源。2.4APP版本管理2.4.1功能描述APP版本管理提供移动应用分发和管理服务，以解决企业移动应用数量和版本越来越多的问题，版本管理包括版本更新和云修复两种方式。版本更新支持对已安装APP按版本进行更新、强制更新和强制关闭；云修复也叫热更新，是指不用发布新的apk或者ipa版本即可对用户手册28/33app进行更新，支持提示修复和静默修复，也支持通过渠道进行不同分类的客户进行区别更新。2.4.2业务规则•版本更新：Android/iOS平台APP版本管理，包括版本上传，版本更新，强制更新，强制关闭；•云修复：Android/iOS平台的APP修复功能，无需提交新版本到应用市场，对指定版本进行修复或根据不同用户渠道范围修复。2.4.3栏目说明栏目名称说明平台应用的系统，Android或iOS版本Android或iOS正式版的版本号应用类型APP或SDK修复方式用于区分修复时的执行逻辑2.4.4操作说明2.4.4.1APP版本管理APP版本管理提供租户中应用的版本信息、版本更新和修复数据统计，可以让企业快速掌握租户下APP版本更新的动态。可快速了解租户中应用的更新、修复情况，同时提供应用的版本更新或云修复功能入口。如下图所示，版本管理列表中展示租户下全部应用的版本号、累计更新次数、修复次数、最近更新时间，支持按应用名称搜索。用户手册29/33版本更新：跳转至应用的版本更新页面，应用的版本发布后可针对已发布的版本进行提示更新、强制更新和强制关闭操作；云修复：跳转至应用的云修复页面，支持全应用修复和渠道修复模式，应用修复又包含提示修复和静默修复，提示修复时APP会有弹出框，提示用户下载更新包、重启app。静默修复不会有提示信息，下次重启，自动生效。用户手册30/332.5APP统计分析2.5.1功能描述APP统计分析针对APP终端安装数据进行统计，包括新增量、累计量、活跃量，使用时长，同时会针对版本数据、终端数据两个维度进行数据统计，让企业实时掌握APP运营数据。2.5.2业务规则•今日新增：首次启动应用的设备安装量；•今日活跃量：今日启动过应用的设备安装量，包括新用户和老用户（去重）；•30天活跃量：30天内启动过应用的设备安装量（去重）；•累计安装量：所有启动过应用的设备安装量（去重）；•启动次数：今日所有设备启动次数总和。2.5.3栏目说明栏目名称说明应用名称移动应用的名称今日新增今日首次启动应用的设备安装量今日活跃今日启动过应用的设备安装量（去重）用户手册31/332.5.4操作说明2.5.4.1APP统计分析APP统计分析展示租户下全部应用的运营数据，运营人员可快速了解应用的运营情况，对应用运营数据一目了然。1）今日新增/活跃量统计如下图所示，柱状图中默认按今日新增排序展示应用数据，默认展示今日新增数最高的5个应用，同时支持切换为按今日活跃数据排序。2）今日新增/活跃量统计列表与柱状图中展示的应用一致，列表中展示更为详细的运营统计数据，包括30天活跃量、累计安装量等，切换列表页时，柱状图展现的数据会同时切换。3）进入每个应用的详细统计报表。用户手册32/33
