:wxfrwk:`打开 App <open-ability/launchApp>`
================================================

此功能需要用户主动触发才能打开 APP，所以不由 API 来调用，
需要用 open-type 的值设置为 launchApp 的 <button> 组件的点击来触发。

当小程序从 APP 分享消息卡片的场景打开（场景值 1036，APP 分享小程序文档 iOS/Android）
或从 APP 打开的场景打开时（场景值 1069），小程序会获得打开 APP 的能力，
此时用户点击按钮可以打开分享该小程序卡片/拉起该小程序的 APP。即小程序不能打开任意 APP，只能 跳回 APP。

在一个小程序的生命周期内，只有在特定条件下，才具有打开 APP 的能力。

.. image:: https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/image/launch-app.png?t=19041921

在基础库 < 2.5.1 的版本，这个能力的规则如下：

当小程序从 1069 场景打开时，可以打开 APP。

当小程序从非 1069 的打开时，会在小程序框架内部会管理的一个状态，为 true 则可以打开 APP，为 false 则不可以打开 APP。
这个状态的维护遵循以下规则：

- 当小程序从 App 分享消息卡片（场景值1036）打开时，该状态置为 true。
- 当小程序从以下场景打开时，保持上一次打开小程序时打开 App 能力的状态：

  - 从其他小程序返回小程序（场景值1038）时（基础库 2.2.4 及以上版本支持）
  - 小程序从聊天顶部场景（场景值1089）中的「最近使用」内打开时
  - 长按小程序右上角菜单唤出最近使用历史（场景值1090）打开时

- 当小程序从非以上场景打开时，不具有打开 APP 的能力，该状态置为 false。


在基础库 >= 2.5.1 时，这个能力的规则如下：

当小程序从任意场景打开时，会在小程序框架内部会管理的一个状态，为 true 则可以打开 APP，为 false 则不可以打开 APP。
这个状态的维护遵循以下规则：

- 当小程序从 App 分享消息卡片（场景值1036）或从 APP 打开的场景打开时（场景值 1069）打开时，该状态置为 true。
- 当小程序从以下场景打开时，保持上一次打开小程序时打开 App 能力的状态：

  - 从其他小程序返回小程序（场景值1038）时（基础库 2.2.4 及以上版本支持）
  - 小程序从聊天顶部场景（场景值1089）中的「最近使用」内打开时
  - 长按小程序右上角菜单唤出最近使用历史（场景值1090）打开时

- 当小程序从非以上场景打开时，不具有打开 APP 的能力，该状态置为 false。


使用方法

小程序端

需要将 <button> 组件 open-type 的值设置为 launchApp。
如果需要在打开 APP 时向 APP 传递参数，可以设置 app-parameter 为要传递的参数。
通过 binderror 可以监听打开 APP 的错误事件。

app 端

APP 需要接入 OpenSDK。 文档请参考 iOS / Android

Android 第三方 app 需要处理 ShowMessageFromWX.req 的微信回调，
iOS 则需要将 appId 添加到第三方 app 工程所属的 plist 文件 URL types 字段。
app-parameter 的获取方法，请参考 Android SDKSample 中 WXEntryActivity 中的 onResp 方法
以及 iOS SDKSample 中 WXApiDelegate 中的 onResp 方法。

代码示例

.. code:: html

  <button open-type="launchApp" app-parameter="wechat" binderror="launchAppError">
    打开APP
  </button>

.. code:: js

  Page({
    launchAppError(e) {
      console.log(e.detail.errMsg)
    }
  })

error 事件参数说明

+---------------+-------------------------------------------------------+
|      值       |                         说明                          |
+===============+=======================================================+
| invalid scene | 调用场景不正确，即此时的小程序不具备打开 APP 的能力。 |
+---------------+-------------------------------------------------------+