# PC 小程序

# PC 小程序介绍

BZ 小程序支持在移动端和 PC 端运行,你可以选择直接使用移动端的小程序代码在 PC 端运行,也可以为你的应用在 PC 端开发独立的小程序。

为了充分利用 PC 端更大的屏幕展示面积,在 PC 端,小程序支持“小窗口”和“大窗口”两种模式,打开场景也更加多样,你可以利用这些特性开发出能力更加强大的小程序应用。

注:PC 宽屏(大窗口)小程序在 BossHi 版本 3.10+ 支持

# PC 小程序代码包

我们同时支持 PC 端使用移动端小程序一样的代码包和使用独立的小程序代码包,你可以根据你的研发习惯选择合适的方式。

默认情况下我们会在 PC 端使用你的移动端小程序代码包,你不需要进行任何的设置,只需要在 PC 端对你的小程序进行必要的功能测试即可。

在同一个工程里开发移动端和 PC 端小程序,你可以选择仅上传一份代码到移动端小程序包、在 PC 端保持使用移动端小程序代码包。

# PC 小程序运行模式

# 小窗口

小程序在 PC 端默认支持小窗口模式,在小窗口模式下运行效果与在移动端比较接近,独立小窗口如下图所示:

# 大窗口

除了小窗口模式,小程序在 PC 端还支持大窗口模式,工作台内嵌大窗口模式的运行效果如下:

要支持大窗口模式,只需要按照小程序的 全局配置说明,通过 app.json 文件 ext > defaultPages 中的 PCMode 配置大窗口模式的默认启动页面即可。

	"pages": [
		{
			"path": "pages/index/index",
			"style": {
				"navigationBarTitleText": "审批"
			}
		},
		{
			"path": "pages/my-approval/index",
			"style": {
				"navigationBarTitleText": "我的审批"
			}
		},
		{
			"path": "pages/desktop-app/index",
			"style": {
				"navigationBarTitleText": "审批"
			}
		}
	],
	"ext": {
		"defaultPages": {
			"sidebarMode": "pages/index/index",  // 窄屏模式启动小程序时的默认启动页面
			"PCMode": "pages/desktop-app/index"  // 宽屏模式启动小程序时的默认启动页面
		}
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# 不同打开形式

除此之外,也可以 通过 Applink 打开小程序

在使用 Applink 打开小程序时,可以通过设置链接中的 mode 参数来控制小程序的启动模式

不同的 openType 参数值在不同情况下的打开效果如下:

openType 参数值 不同场景下的启动形式 图示
openType=1 会以独立小窗口的形式打开 image.png
openType=2 会以工作台 tab 的大窗口形式打开 image.png
openType=3 会以独立大窗口的形式打开 image.png
openType=4 会以侧边栏的形式打开 image.png

# 注意

注意:

  • PCMode 仅在工作台宽屏场景生效,Applink 场景即使指定 openType为2/3 以大窗口形式打开,也不根据 PCMode 走,会默认打开小程序首页。
    如果 Applink openType为2/3 的场景,你想打开 PCMode 页面的大窗口,可以在 Applink 上拼接 pathPc 或 path 为 PCMode 指定的页面去实现。
最后更新于 : 4/21/2023, 2:36:17 PM