![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11973325/4d27948dd15b72d5e2155d4bd563488a.png)
现在，很多APP都从H5混合开发升级为“Native+小程序”的开发架构，接下来从自身团队的开发经历出发，分享一下，如何当APP引入小程序之后，用户打开一个小程序后，背后的运行机制。
整体包括：打开方式、启动模式、关闭方式、预加载机制～

---

## 打开小程序的几种方式

APP里打开小程序有几种不同方式，分别对应不同的业务场景。

**最常用的方式：通过小程序ID直接打开**

```objectivec
FATAppletRequest *request = [[FATAppletRequest alloc] init];
request.appletId = @"小程序id";       // 必填
request.apiServer = @"服务器地址";    // 必填

[[FATClient sharedClient] startAppletWithRequest:request
                          InParentViewController:self
                                      completion:^(BOOL result, FATError *error) {
    NSLog(@"打开小程序结果: %@", error);
} closeCompletion:^{
    NSLog(@"小程序被关闭了");
}];
```

这个接口只需要两件事：小程序的ID和服务器地址。SDK 内部会处理下载、校验、启动的流程。如果本地已经有缓存的小程序包，SDK 会先打开本地版本，然后后台检查服务器端有没有新版本，有新版本就下载，下一次打开时用新版本。

**扫码打开**

扫描 FinClip 管理平台上的二维码，可以打开小程序的各种版本——正式版、体验版、审核版、真机调试版、预览版都可以。

```objectivec
FATAppletQrCodeRequest *qrcodeRequest = [[FATAppletQrCodeRequest alloc] init];
qrcodeRequest.qrCode = qrCode;  // 二维码里的内容

[[FATClient sharedClient] startAppletWithQrCodeRequest:qrcodeRequest
                                  inParentViewController:self
                                        requestBlock:^(BOOL result, FATError *error) {
    NSLog(@"校验二维码完成: %@", error);
} completion:^(BOOL result, FATError *error) {
    NSLog(@"打开完成: %@", error);
} closeCompletion:^{
    NSLog(@"关闭了");
}];
```

**通过 URL Scheme 从外部唤起**

有些场景希望从 Safari 或者其他 App 直接跳转到自己的 App 并打开某个小程序，可以通过 URL Scheme 实现。需要先在 APP 里配置 URL Types，格式是 `fat` + SDKKey 的 MD5 值。

```objectivec
// 在 AppDelegate 中实现
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options {
    if ([[FATClient sharedClient] handleOpenURL:url]) {
        return YES;
    }
    return NO;
}
```

外部调用的 URI 格式是：`fat705b46f78820c7a8://applet/appid/617bb42f530fb30001509b27?path=pages/index/index&query=key%3Dvalue`

---

## 冷启动 vs 热启动：发生了什么
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11973325/87836a13396e3c80d7534f458677d508.png)


理解"冷启动"和"热启动"的区别，是理解整个生命周期的前提。

**冷启动**：用户第一次打开，或者小程序被销毁后再次打开。此时 SDK 需要从服务器下载小程序包、校验签名、初始化 JS 引擎、渲染页面。首次打开的时候，这一步会比较慢，尤其是网络条件不好的时候。

**热启动**：用户之前已经打开过这个小程序，小程序还在后台挂着。这时候只需要把后台的小程序切换到前台，不需要重新下载和初始化，速度会快很多。

从 SDK 的角度，打开小程序时会发生这样的判断逻辑：

1. 检查本地是否有缓存的小程序包
2. 如果没有 → 下载小程序包 → 下载基础库 → 初始化 → 渲染
3. 如果有 → 先打开本地包 → 后台检查新版本 → 有新版则下载备用

如果本地有缓存，冷启动的体验会好很多。

---

## 离线包：把首次启动变快
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11973325/7554105d755d65c43b871cb00e128593.png)

冷启动慢，最直接的原因是要从服务器下载小程序包和基础库。SDK 支持"离线包"机制——把小程序包和基础库预先打包进 APP，在合适的时机（比如用户刚登录的时候）提前下载好。

```objectivec
FATAppletRequest *request = [[FATAppletRequest alloc] init];
request.appletId = @"小程序id";
request.apiServer = @"服务器地址";
// 小程序离线包地址，可以是 bundle 路径，也可以是沙盒路径
request.offlineMiniprogramZipPath = [[NSBundle mainBundle] pathForResource:@"api_demo" ofType:@"zip"];
// 基础库离线包地址
request.offlineFrameworkZipPath = [[NSBundle mainBundle] pathForResource:@"framework-3.0.49" ofType:@"zip"];

[[FATClient sharedClient] startAppletWithRequest:request
                          InParentViewController:self.window.rootViewController
                                      completion:^(BOOL result, FATError *error) {
    NSLog(@"打开小程序: %@", error);
} closeCompletion:^{
    NSLog(@"关闭小程序");
}];
```

注意：离线启动时，`offlineMiniprogramZipPath` 和 `offlineFrameworkZipPath` 必须同时传，否则 SDK 会忽略离线配置，走正常的下载流程。

还有一个更自动的做法：初始化 SDK 的时候开启基础库预下载。

```objectivec
FATStoreConfig *storeConfig = [[FATStoreConfig alloc] init];
storeConfig.sdkKey = @"##sdkKey##";
storeConfig.sdkSecret = @"##sdkSecret##";
storeConfig.apiServer = @"##apiServer##";
// 开启基础库预下载
storeConfig.enablePreloadFramework = YES;
FATConfig *config = [FATConfig configWithStoreConfigs:@[storeConfig]];
[[FATClient sharedClient] initWithConfig:config error:nil];
```

开了这个选项之后，SDK 会在初始化时自动下载基础库到本地，下次打开任何小程序都会快很多。

---

## 热启动的参数控制

热启动有一个容易踩坑的地方：启动参数。

用户第一次打开小程序时带了参数（比如从某个营销页跳转过来），小程序已经打开了。用户退到后台，过了一会儿又从后台切回来，这时候如果带了新的启动参数，SDK 会怎么处理？

SDK 提供了 `reLaunchMode` 参数来控制这个行为，有四种模式：

- `FATReLaunchModeParamsExist`：启动参数中包含 path、query 或 referrerInfo，并且其中某个参数不为空，则执行 reLaunch
- `FATReLaunchModeOnlyParamsDiff`：启动参数与上一次的不同时，才执行 reLaunch
- `FATReLaunchModeAlways`：每次热启动都执行 reLaunch
- `FATReLaunchModeNever`：每次热启动都不执行 reLaunch

默认是 `ParamsExist` 模式，即只要带了新参数就 reLaunch。业务上如果对页面栈行为有要求，可以在初始化或每次调用 `startAppletWithRequest` 时显式设置这个参数。

---

## 关闭小程序不等于销毁小程序

很多开发者会混淆"关闭"和"销毁"这两个动作。

点击右上角胶囊的关闭按钮，或者调用 SDK 的关闭接口：

```objectivec
// 关闭指定的小程序（animated 是否动画，completion 关闭完成回调，closeCompletion 小程序关闭回调）
[[FATClient sharedClient] closeApplet:@"小程序id" animated:YES completion:^{
    NSLog(@"关闭完成");
} closeCompletion:^{
    NSLog(@"小程序被关闭了");
}];

// 关闭所有小程序
[[FATClient sharedClient] closeAllAppletsWithCompletion:^{
    NSLog(@"全部关闭了");
}];
```

关闭之后，小程序并没有从内存里删除——它只是退到了后台，进入了"挂起"状态。等用户下次再打开，会立即切换到前台，不需要重新下载。

如果要彻底清内存，需要调用销毁接口：

```objectivec
// 销毁指定小程序（会清掉内存和缓存）
[[FATClient sharedClient] clearMemeryApplet:@"小程序id"];

// 销毁所有小程序
[[FATClient sharedClient] clearMemoryCache];
```

注意：如果小程序正在显示中，直接调用销毁接口不会生效——需要先调用关闭接口把它退到后台，再调用销毁接口才行。这是 SDK 防止误操作的保护设计。

---

## 删除小程序：连缓存一起清掉

如果不只清内存，还想连本地存储的小程序包和配置信息一起清掉，需要调用删除接口：

```objectivec
// 删除指定小程序的所有本地信息
[[FATClient sharedClient] removeAppletFromLocalCache:@"小程序id"];

// 删除所有小程序的本地信息
[[FATClient sharedClient] clearLocalApplets];
```

删除之后再打开，SDK 会重新从服务器下载，等同于首次安装的效果。用户换账号、清缓存、需要强制重新初始化的时候，用这个接口。

---

## 批量预加载：改善用户体验

如果你的 APP 有多个小程序入口，用户可能会打开多个。可以提前把需要的小程序包下载好，减少等待时间。

```objectivec
// 批量下载小程序
[[FATClient sharedClient] downloadApplets:appIds
                               apiServer:apiServer
                                complete:^(NSArray *results, FATError *error) {
    // results 是一个数组，每个元素是 @{@"appId": xxx, @"success": xxx, @"needUpdate": xxx}
    // needUpdate 为 false 说明本地已经是最新版本，不需要重复下载
}];
```

这个接口会检查本地缓存，如果某个小程序已经是最新版本，就不会重复下载，只返回结果通知你。

---

## iPad 多窗口模式：小程序不只是全屏打开

在 iPad 上，小程序可以不全屏打开。SDK 支持多种窗口模式，方便你同时操作小程序和原生页面。

SDK 支持以下几种模式：

- **fullScreen**：默认全屏模式
- **currentContext**：在指定的上下文控制器中显示，可以配合 UISplitViewController 使用
- **overCurrentContext**：遮罩模式，不影响原有视图栈
- **pageSheet**：半屏弹窗，不可设置大小
- **formSheet**：居中弹窗，大小由系统决定
- **popover**：气泡弹窗，有箭头指向触发按钮
- **custom**：自定义窗口区域

```objectivec
// 以 pageSheet 模式打开小程序
request.presentationConfig = [FATAppletPresentationConfig pageSheetPresentationConfig];
```

如果你的 APP 主要面向 iPad 用户，这些窗口模式可以显著提升用户体验——用户不需要在小程序和 APP 原生页面之间来回切换，可以在同一个屏幕上同时操作。

---


先写到这里，如果感兴趣的话可以在Gitee上详细了解：[Gitee 代码地址](https://gitee.com/finclip/)



现在，很多APP都从H5混合开发升级为“Native+小程序”的开发架构，接下来从自身团队的开发经历出发，分享一下，如何当APP引入小程序之后，用户打开一个小程序后，背后的运行机制。整体包括：打开方式、启动模式、关闭方式、预加载机制～

在APP里打开一个小程序，背后发生了什么——小程序运行全生命周期管理

从APP运行角度的视角分享一下：给APP接入小程序容器后，从打开方式、冷热启动、离线包、热启动参数控制，到关闭/销毁/删除的区别、批量预加载、iPad多窗口模式，一文讲透小程序全生命周期，理解SDK的运行逻辑～

客户端

架构设计

后端

本文详解APP引入小程序后的运行机制，涵盖打开方式、启动模式、关闭与预加载机制。通过代码示例解析冷热启动差异、离线包优化及iPad多窗口模式，帮助开发者提升用户体验与性能。

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在APP里打开一个小程序，背后发生了什么——小程序运行全生命周期管理-腾讯云开发者社区-腾讯云

在APP里打开一个小程序，背后发生了什么——小程序运行全生命周期管理

在APP里打开一个小程序，背后发生了什么——小程序运行全生命周期管理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐