非框架插件桌面产品打包上架

最后更新时间:2020年12月28日

1.引言

1.1 目的与意义

本文档主要讲述“非框架+插件产品”开发及上架的完整流程,主要包括前期的环境部署、授权的使用方式、产品开发、打包、上架的方法等内容。另外, 针对过程中的一些重难点,进行了详细的说明。通过阅读本文档,二次开发者可以熟悉产品从最初产生到最终上架的整个流程。

1.2 预期读者

二次开发人员、二次开发合作伙伴。

1.3 环境要求

1.3.1 硬件要求

CPU:Intel(R)Core(TM)i5-4200U ®1.6GHZ 及以上

内存:2G 及以上

1.3.2 软件要求

操作系统:Windows 7、Windows 8、Windows 10

开发软件:Visual Studio 2010 及以上

GIS 环境:MapGIS 10.5桌面开发包、开发授权

2.流程图

流程图

3.环境部署

基于 MapGIS 10.5 进行桌面二次开发,需要获取开发环境及开发授权,以完成环境部署。下面详细讲述环境部署的流程及方法。

3.1 注册并登录司马云

二次开发用户要获取 MapGIS 10.5 开发环境及授权,需登录司马云网站 www.smaryun.com。对于初次进入司马云的开发者而言,需先用邮箱或手机号进行账号注册,注册成功后登录司马云。如图 1 司马云初始界面,图 2 注册司马云账号所示。

司马云初始界面

图 1 司马云初始界面

注册司马云账号

图 2 注册司马云账号

3.2 升级成为开发者

登录司马云后,首先要升级成为开发者。点击“云开发世界”,在下方点击 “升级成为开发者”即可。如图 3 升级成为开发者所示。

升级成为开发者

图 3 升级成为开发者

3.3 下载产品开发包

依次点击“云开发世界”->“资源中心”->“产品开发包”。进行非框架插件式桌面开发,需下载MapGIS 10 X64 桌面开发包(for .NET)。该产品开发包除带有SDK外,还附带MapGIS 10.5 Desktop ,可进行桌面平台操作,如图 4 下载桌面开发包所示。

下载桌面开发包

图 4 下载桌面开发包

3.4 获取开发授权

3.4.1 授权申请

进行二次开发,除需获取产品开发包外,还需获取开发授权。在开发世界的工作台中,依次点击“开发环境”->“获取开发授权”,进入到授权申请界面。

授权申请

图 5 授权申请

完成手机号、邮箱、微信号的绑定认证后,即可在图 5 所示界面中免费获取基础开发授权。由于是基础开发授权,在功能及数据量上存在一定限制,如果想使用三维、网络数据库等功能模块,则需使用高级开发授权。

点击申请高级开发授权,完善申请资料,等待审核通过。审核通过后,即可下载使用高级开发授权,如图 6 授权下载所示。

授权下载

图 6 授权下载

3.4.2 授权绑定

无论是基础开发授权还是高级开发授权,下载到本地都是一个后缀为 reg 的授权文件。双击该文件,文件与机器绑定后,还需进行联网握手,才能完成开发

授权的认证。下面将介绍联网状态下授权握手认证的方法。

3.4.3 授权认证

在联网状态下,启动 MapGIS 10.5 桌面平台,即可自动完成授权握手。在桌面平台工具中,点击“帮助”菜单下的“关于 MapGIS”按钮,可看到授权的认证情况。

查看授权认证情况

图 7 查看授权认证情况

3.4.4 授权解绑

需要注意的是,一个授权对应一台电脑,如果该授权想在其他电脑上使用, 首先要解除与当前电脑的绑定。具体操作如下:点击工作台的“开发环境”,可看到授权的绑定信息。点击解除绑定按钮,系统会向关联的手机号上发送验证码,信息验证通过后,即可成功解绑。

授权解绑

图 8 授权解绑

4.开发产品

桌面开发包安装完成、授权认证成功后,MapGIS桌面开发环境即部署完成,可利用Visual Studio 2010开发工具进行MapGIS 10.5的桌面二次开发。

二次开发用户在进行桌面开发时,可从开发世界的资源中心里获取各类开发资源,包括:开发文档、视频资源、API文档等。桌面API文档中提供了大量的接口和方法,还提供了丰富的示例资源,方便开发者快速掌握MapGIS桌面开发的体系和方法。

MapGIS Desktop API为用户在线API(应用程序编程接口),用户可以通过API查找学习MapGIS提供的实现功能的方法。

在线访问地址: http://develop.smaryun.com:81/API/DesktopAPI/MapGISDesktop/index.htm

MapGIS Desktop API

图 9 MapGIS Desktop API

5.打包产品(重要)

产品功能代码开发及调试完成后,还要在程序入口处添加获取授权信息的代码。具体步骤如下:

1.在司马云“开发世界”->“工作台”->“产品授权”中,点击“复制 Key” 按钮,获取产品授权码,即左侧的云授权 Key。

2.在程序的Program.cs类文件中,添加授权Key绑定代码:

    MapGIS.PluginEngine.RegisterApp.InitLicenseKey("w8Vz6Vodz0B71w5j");

获取授权 Key

图 10 获取授权 Key

添加授权绑定代码

图 11 添加授权绑定代码

授权代码添加完成,即可将产品运行 exe 或产品安装程序打包压缩成 zip 文件,作为后续在司马云交易中心上传的资源文件。至此,产品的开发及打包工作已完成,接下来介绍产品在司马云交易中心上架的流程。

6.上架产品

产品开发完成后,要在司马云的交易中心上架,以便终端用户购买并使用产品。点击“工作室”->“产品管理”->“上传新产品”->“桌面工具”,进入产品上传页面。

上传桌面产品

图 12 上传桌面产品

选择“非框架+插件产品”,将此前复制的云授权 Key,输入到文本框中。

完善产品信息

图 13 完善产品信息

根据页面提示,输入相关产品信息,如:产品资源文件、产品售价、试用天数、运行环境、产品图标及描述等内容。信息填写完毕,检查无误后,提交审核即可。

另外,产品上架时要选择所需的功能组,每个功能组都对应了一个价钱。在设置产品售价时,即便设置为 0,最终上架的产品也会包括所选功能组的价钱。所以,如果客户已经在线下购买了产品,可联系商务部进行代购。

待产品审核通过后,会上架到交易中心板块,终端用户即可进行购买使用。

产品上架成功

图 14 产品上架成功