# 插件功能页面

小程序基础库2.1.0版本开始支持插件功能页面。

有些接口不能直接在插件中调用（如wx.），但插件开发者可以使用插件功能页面来实现功能。目前插件功能页面包括：

从基础库版本2.22.1开始，废弃了以下功能页面，可以直接调用相应的接口来实现功能：

从基础库版本2.16.1开始，废弃了以下三个功能页面，可以直接调用对应的接口来实现功能；原来的和新使用的点击后不会跳转到功能页面，而是直接生效：

使用插件功能页面，需要先激活功能页面特性，配置对应的功能页面功能，然后使用-page-组件跳转到插件功能页面，实现对应的功能。详情请参阅下文。

在使用插件功能页面之前，需要确保插件已经激活，否则可能会出现-页面-点击后无反应等情况。

# 插件所有者小程序

在开始开发之前，我们需要知道插件功能页面是指插件主小程序中的一个特殊页面。

插件所有者小程序是指与插件相同的小程序。例如，“小程序示例”小程序开发了一个“小程序示例插件”，那么无论该插件被哪个小程序使用，该插件的插件所有者小程序都是“小程序示例插件”。程序示例”。下面将继续使用术语插件所有者小程序。

# 插件主小程序开发方法

通常，当您开始使用插件功能页面时，需要打开两个开发者工具窗口，其中一个打开插件项目，另一个打开插件所有者小程序的小程序项目。例如，一个打开“小程序示例插件”项目，另一个打开“小程序示例”项目。

这两个窗口中，前者用于编辑插件，后者用于编辑插件所有者小程序。下面插件所有者小程序中需要编辑的所有内容都将在后者中完成。

# 激活功能页面特性

要调用插件中的插件功能页面，需要先激活插件主小程序的功能页面功能。具体来说，在插件所有者小程序的app.json文件中添加一个定义部分，并将其值设置为true，例如：

代码示例：

{

"functionalPages": { "independent": true } }

目前兼容旧的写法：

{ "functionalPages": true }

以后将取消对旧写法的支持，以后将无法编译和上传。

这两种写法的区别在于，新的写法 "": true 会让插件功能页面的代码独立于其他代码，也就是说插件功能页面可以独立下载和加载，更好的性能。但也使得插件功能页面目录-/（支付功能页面会使用其中的文件）无法使用该目录之外的文件（反之亦然：该目录之外的文件无法调用该目录内的文件）。

注意，添加或更改该字段时，需要发布该小程序的新版本，才可以在官方环境中使用插件功能页面。

# 跳转到功能页面

功能页面不能使用wx.跳转，但需要一个名为 -page- 的组件。以获取用户信息为例，可以在插件中放置以下-page-：

代码示例：

<functional-page-navigator name="loginAndGetUserInfo" args="" version="develop" bind:success="loginSuccess"> <button>登录到插件button> functional-page-navigator>

当用户点击这个时，会自动跳转到插件主小程序对应的功能页面。该功能页面会提示用户登录或进行其他相应操作。操作结果将以组件事件的形式返回。

-page-的参数及详细使用方法请参考组件说明。

从小程序基础库2.4.0版本开始，支持插件主小程序跳转到自己的功能页面。当基础库版本低于2.4.0时，点击-页面-跳转到自己的功能页面将不起作用。

# 实机开发和测试的常规步骤

目前，跳转到功能页面不支持在开发者工具中进行调试。请在真实设备上测试。第一次进行真机开发测试时，通常的步骤如下：

在开发者工具上打开插件主小程序项目，点击“预览”；使用测试用真机扫描预览二维码。此时，您将进入插件所有者小程序。进入后可以直接退出该小程序。程序;在开发者工具上打开插件项目，将插件中的-page-中的属性设置为；点击预览，生成插件预览二维码，用真机扫码进行测试，预览功能页面；如果更改了插件代码，重新生成并扫描插件的预览二维码；如果一段时间后跳转功能页面出现“开发版已过期”等提示，请从步骤1开始重试。

注意：-page- of= 仅用于调试，因此在审核插件之前，您需要：

确保您已使用 "": true set 发布了插件所有者小程序；确保所有 -page- 组件属性均设置为 "" 。 # 功能页面FAQ # 如何正确编辑插件主小程序？ # 单击-page-后没有任何反应。 # 点击-page-后，显示一个页面，提示“页面不存在”。 # 点击后弹窗提示“小程序开发版已过期”。 # 点击后，弹出“无法使用该功能”的页面。 # 点击后，点击页面“支付”按钮，立即退出支付功能页面。 # 点击-page-后，显示一个只有返回按钮的页面。 # 开发版可以正常跳转，但是反馈不能。 #错误与提示