01- V15 主程序安装与使用说明 - OrDroid APP 相关

# 1. 概述
主程序，一般指 OrDroid 软件下的 OrDroid.apk 文件，首次使用，需要把apk文件成功安装到终端设备上。

# 2.主程序安装
主程序首次安装，需要在 PKM 下载最新的版本 OrDroid 文件，安装到设备中，后续就无需手动安装，可以通过主程序来在线升级更新。

# 3. 权限设置
1）在使用OrDroid主程序前，需要检查App主要权限是否已经勾选，权限设置路径一般为(具体设置会根据不同品牌的PDA、手机、平板而有所不同，本文仅作参考)，设置->应用->应用管理->OrDroid->权限，如下图所示。
![](/media//202206/2022-06-01_105756.png)

2）找到应用权限设置，把存储、电话、位置、相机、麦克风等权限都打开，如下图所示。
![](/media//202206/2022-06-01_105927.png)

![](/media//202206/2022-06-01_110057.png)

# 4. 系统信息页
系统信息主要记录了设备名称、设备Android Id、App版本号、WCF地址、插件库地址、WCF版本、数据库名称等。登录后，在"我"->"系统信息"，即可查看。

![](/media//202206/2022-06-01_113016.png)

![](/media//202206/2022-06-01_113049.png)

# 5. 在线用户列表 Onlist list
在线用户列表记录了当前在系统登录的用户。登录后，在"我"->"在线用户列表"，即可查看。

![](/media//202206/2022-06-01_140957.png)

![](/media//202206/2022-06-01_141029.png)

# 6. 检查更新 Check for updates
用户可通过此功能检查OrDroid系列APP最新版本，并通过此功能下载安装/更新APP。设置APP更新需要以下步骤。
1) 从PKM“产品”分组下的“软件版本管理”下载对应的Apk文件，下载完成后将Apk文件拷贝到“应用服务器插件库”下指定目录中（存放目录可自定义），如图。
![](/media//202206/2022-06-01_163358.png)

2) 在"系统参数管理"元对象插件中，找到参数[OrDroid Release Revision]，维护相关Apk文件，附加参数值为每个Apk文件的最新版本号（最新版本号可参考PKM维护的版本号），如图。
![](/media//202206/2022-06-01_163903.png)

3) 在消息对象插件中，发布一条抬头为"OrDroidAppUpdate"的消息。
![](/media//202209/2022-09-17_140433.png)

3) 登录后，在"我"->"检查更新 Check for updates"，即可查看，当出现 New 标识，说明有更新的版本。
![](/media//202209/2022-09-17_141541.png)

![](/media//202206/2022-06-01_160911.png)

# 7. 扫码登录
1) 二维码内容
二维码内容格式:User+Password+OrDroid，中间 + 号隔开。

2) 移动端扫码步骤:
- 选择扫码界面
- 调用摄像头扫码(此功能需要启用APP摄像头权限)

![](/media//202208/2022-08-09_170446.png)

# 8. 未操作自动退出登录
在"系统参数管理"元对象插件中，检索参数名为"[Password Security Policy]"(不存在则新增)，选中参数值为"BrowserAutoExitMinutes"的系统参数(不存在则新增)，修改附加参数值为大于0的数值(小于等于0时，此系统参数不生效，附件参数值单位为分钟)，即可实现OrDroid APP与平台未操作下实时自动退出登录，如图。
![](/media//202212/2022-12-27_103142.png)

# 9. 数据库标识
9.1 为方便用户识别当前登录的数据库环境，可在"系统参数管理"中增加"[OrDroid DataBase Info]"参数名，参数值用户可自定义为哪个环境，如下图。
![](/media//202307/2023-07-20_114913.png)
9.2 效果图
![](/media//202307/2023-07-20_114852.png)

# 10. 检索插件组或者插件
10.1 弹出查询文本框
![](/media//202309/2023-09-13_142425.png)
10.2 按插件组查询
![](/media//202309/2023-09-13_142655.png)
10.3 按插件名查询
![](/media//202309/2023-09-13_142842.png)
10.4 按插件命令查询
![](/media//202309/2023-09-13_153058.png)
10.5 还原插件列表(只需清空查询文本框或者上拉、下拉列表即可)
![](/media//202309/2023-09-13_153246.png)

# 11. 插件使用历史记录
11.1 为提供客户更好的使用体验，现增加”插件使用历史记录“功能，客户在使用过程中打开的插件，都可以在”插件使用历史记录“中显示。
11.2 新增数据表"OrDroidPluginHistory"，如下图。
![](/media//202405/2024-05-11_142751.png)
11.3 新增存储过程"PDA_OrDroidPluginHistoryRecord"，如下。
```sql
-- =============================================
-- Author：		<Bob>
-- Create date： <2024.04.23>
-- Description： 记录打开OrDroid插件历史
-- =============================================
ALTER PROCEDURE [dbo].[PDA_OrDroidPluginHistoryRecord]
@I_Sender nvarchar(200)='', --客户端执行按钮
@I_ReturnMessage nvarchar(max)='' output,  --返回的信息,支持多语言
@I_ExceptionFieldName nvarchar(100)='' output, --向客户端报告引起冲突的字段
@I_LanguageId char(1)='1',				--客户端传入的语言ID
@I_PlugInCommand varchar(5)='',		--插件命令
@I_OrBitUserId char(12)='',			--用户ID
@I_OrBitUserName nvarchar(100)='',	--用户名
@I_ResourceId	char(12)='',		--资源ID(如果资源不在资源清单中，那么它将是空的)
@I_ResourceName nvarchar(100)='',	--资源名
@I_PKid char(12) ='',				--主键
@I_ParentPKId char(12)='',			--父级主键
@I_Parameter nvarchar(100)='',		--插件参数
--以上变量为系统服务固定接口参数，必须在每一个DoEvent过程中实现.

@MenuGroupId CHAR(12)='',
@OrDroidPluginName NVARCHAR(100)=''

AS
BEGIN
	-- SET NOCOUNT ON added to prevent extra result sets from
	-- interfering with SELECT statements.
	SET NOCOUNT ON;
	SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED

DECLARE @OrDroidPluginHistoryId CHAR(12)=''
	DECLARE @OrDroidPluginId CHAR(12)=''
	
	SELECT @OrDroidPluginId=OrDroidPluginId 
	FROM dbo.OrDroidPlugin
	WHERE OrDroidPluginName=@OrDroidPluginName

IF EXISTS(SELECT OrDroidPluginHistoryId FROM dbo.OrDroidPluginHistory WHERE OrDroidPluginId=@OrDroidPluginId AND MenuGroupId=@MenuGroupId)
	BEGIN
	    UPDATE dbo.OrDroidPluginHistory
		SET CreateDate=GETDATE()
		WHERE OrDroidPluginId=@OrDroidPluginId
		AND MenuGroupId=@MenuGroupId
	END
	ELSE
	BEGIN
	    EXEC [dbo].[SysGetObjectPKId]
			 @ObjectName = N'OrDroidPluginHistory',
			 @PKID = @OrDroidPluginHistoryId OUTPUT

INSERT INTO dbo.OrDroidPluginHistory
		(
			OrDroidPluginHistoryId,
			MenuGroupId,
			OrDroidPluginId,
			UserId,
			CreateDate
		)
		VALUES
		(   @OrDroidPluginHistoryId,     -- OrDroidPluginHistoryId - char(12)
			@MenuGroupId,   -- MenuGroupId - char(12)
			@OrDroidPluginId,   -- OrDroidPluginId - char(12)
			@I_OrBitUserId,   -- UserId - char(12)
			DEFAULT -- CreateDate - datetime
			)
	END

RETURN 0
END
```
11.4 新增存储过程"OrDroid_GetOrDroidPluginHistory"，如下。
```sql
-- =============================================
-- Author：		<HF0028>
-- Create date： <2024.04.24>
-- Description： OrDroid 获取用户插件使用记录
-- =============================================
ALTER PROCEDURE [dbo].[OrDroid_GetOrDroidPluginHistory]
@I_Sender nvarchar(200)='', --客户端执行按钮
@I_ReturnMessage nvarchar(max)='' output,  --返回的信息,支持多语言
@I_ExceptionFieldName nvarchar(100)='' output, --向客户端报告引起冲突的字段
@I_LanguageId char(1)='1',				--客户端传入的语言ID
@I_PlugInCommand varchar(5)='',		--插件命令
@I_OrBitUserId char(12)='',			--用户ID
@I_OrBitUserName nvarchar(100)='',	--用户名
@I_ResourceId	char(12)='',		--资源ID(如果资源不在资源清单中，那么它将是空的)
@I_ResourceName nvarchar(100)='',	--资源名
@I_PKid char(12) ='',				--主键
@I_ParentPKId char(12)='',			--父级主键
@I_Parameter nvarchar(100)=''		--插件参数
--以上变量为系统服务固定接口参数，必须在每一个DoEvent过程中实现.

AS
BEGIN
	-- SET NOCOUNT ON added to prevent extra result sets from
	-- interfering with SELECT statements.
	SET NOCOUNT ON;
	SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED

SELECT TOP (100) PERCENT
       dbo.SysMenuGroup.MenuGroupId,
       dbo.SysMenuGroup.MenuGroupName AS MenuGroupName1,
       ISNULL(dbo.SysText.Text2, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName2,
       ISNULL(dbo.SysText.Text3, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName3,
       ISNULL(dbo.SysText.Text4, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName4,
       ISNULL(dbo.SysText.Text5, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName5,
       ISNULL(dbo.SysText.Text6, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName6,
       ISNULL(dbo.SysText.Text7, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName7,
       ISNULL(dbo.SysText.Text8, dbo.SysMenuGroup.MenuGroupName) AS MenuGroupName8,
       OrDroidPlugin.OrDroidPluginId,
       SysMenuOD.MenuSequence,
       SysText_1.Text1 AS PluginName1,
       ISNULL(SysText_1.Text2, SysText_1.Text1) AS PlugInName2,
       ISNULL(SysText_1.Text3, SysText_1.Text1) AS PlugInName3,
       ISNULL(SysText_1.Text4, SysText_1.Text1) AS PlugInName4,
       ISNULL(SysText_1.Text5, SysText_1.Text1) AS PlugInName5,
       ISNULL(SysText_1.Text6, SysText_1.Text1) AS PlugInName6,
       ISNULL(SysText_1.Text7, SysText_1.Text1) AS PlugInName7,
       ISNULL(SysText_1.Text8, SysText_1.Text1) AS PlugInName8,
       dbo.OrDroidPlugin.OrDroidPluginCommand,
       dbo.OrDroidPlugin.OrDroidPluginName,
       dbo.OrDroidPlugin.OrDroidPluginFileName,
       dbo.OrDroidPlugin.ReportURL,
       dbo.OrDroidPlugin.IsHorizontal,
       dbo.OrDroidPlugin.OrDroidPluginType,
       dbo.OrDroidPlugin.IsPlaySound,
       dbo.OrDroidPlugin.MsgRow,
       dbo.OrDroidPlugin.RefreshTime,
       dbo.OrDroidPlugin.IsAutoColumnWidth,
       dbo.OrDroidPlugin.PluginPackageName,
       dbo.OrDroidPlugin.PluginClassPath,
       CASE
           WHEN ISNULL(dbo.OrDroidPlugin.MsgWidth, 0) <= 1500 THEN
               1500
           ELSE
               ISNULL(dbo.OrDroidPlugin.MsgWidth, 0)
       END AS MsgWidth
	FROM dbo.OrDroidPluginHistory
		INNER JOIN dbo.OrDroidPlugin
			ON dbo.OrDroidPlugin.OrDroidPluginId = dbo.OrDroidPluginHistory.OrDroidPluginId
		INNER JOIN dbo.SysMenuOD
			ON SysMenuOD.MenuGroupId = OrDroidPluginHistory.MenuGroupId
			   AND SysMenuOD.OrDroidPluginId = OrDroidPluginHistory.OrDroidPluginId
		INNER JOIN dbo.SysMenuGroup
			ON SysMenuGroup.MenuGroupId = dbo.OrDroidPluginHistory.MenuGroupId
		LEFT OUTER JOIN dbo.SysText AS SysText_1
			ON dbo.OrDroidPlugin.OrDroidPluginId = SysText_1.TextModule
		LEFT OUTER JOIN dbo.SysText
			ON dbo.SysMenuGroup.MenuGroupId = dbo.SysText.TextModule
	WHERE OrDroidPluginHistory.UserId = @I_OrBitUserId
	GROUP BY dbo.SysMenuGroup.MenuGroupId,
			 dbo.SysMenuGroup.MenuGroupName,
			 SysText_1.Text2,
			 SysText_1.Text3,
			 SysText_1.Text4,
			 SysText_1.Text5,
			 SysText_1.Text6,
			 SysText_1.Text7,
			 SysText_1.Text8,
			 dbo.SysText.Text2,
			 dbo.SysText.Text3,
			 dbo.SysText.Text4,
			 dbo.SysText.Text5,
			 dbo.SysText.Text6,
			 dbo.SysText.Text7,
			 dbo.SysText.Text8,
			 SysText_1.Text1,
			 SysMenuOD.MenuSequence,
			 dbo.OrDroidPlugin.OrDroidPluginCommand,
			 dbo.OrDroidPlugin.OrDroidPluginName,
			 dbo.OrDroidPlugin.OrDroidPluginFileName,
			 dbo.OrDroidPlugin.ReportURL,
			 dbo.OrDroidPlugin.IsHorizontal,
			 dbo.OrDroidPlugin.OrDroidPluginType,
			 dbo.OrDroidPlugin.IsPlaySound,
			 dbo.OrDroidPlugin.MsgRow,
			 dbo.OrDroidPlugin.RefreshTime,
			 OrDroidPlugin.OrDroidPluginId,
			 OrDroidPlugin.IsAutoColumnWidth,
			 dbo.OrDroidPlugin.MsgWidth,
			 dbo.OrDroidPlugin.PluginPackageName,
			 dbo.OrDroidPlugin.PluginClassPath,
			 OrDroidPluginHistory.CreateDate
	ORDER BY OrDroidPluginHistory.CreateDate DESC

RETURN 0
END
```
11.5 效果图，如下。
11.5.1 插件列表
![](/media//202405/2024-05-11_143234.png)
11.5.2 插件使用历史记录
![](/media//202405/2024-05-11_143348.png)

# 12 异常日志
当程序产生异常/APP闪退后，可在此路径"Android/Data/com.ordroid.host/cache/log/"下的日志文件提交给开发人员协助解决。