抖音开放平台Logo
开发者文档
小程序
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 能力教程
  • 性能优化
  • 安全

    • 小程序运行时

    收藏
    我的收藏

    ​运行环境​

    抖音小程序运行在小程序 SDK 上，但是由于 SDK 嵌入的宿主不同，小程序 SDK 提供的能力集合可能会根据宿主的不同而变化。​
      •​在 iOS 中，小程序的逻辑层 JavaScript 代码运行在 JavaScriptCore 中，视图层由 WKWebView 进行渲染。​
      •​在 Android 中，小程序的逻辑层 JavaScript 代码运行在 V8 中，视图层由 Mobile Chrome 进行渲染。​
    由于小程序在不同的操作系统/宿主下，能力与样式的支持并不完全相同，所以在开发者工具中完成开发之后，需要在不同环境下对自己的小程序进行验证，验证无问题后再上传。​

    ​运行机制​

    ​启动​

    小程序启动会有两种方式，冷启动和热启动。​
      •​冷启动：用户首次打开小程序，或小程序被主动销毁（后台运行超过 5 分钟）后再次打开时，小程序需要重新加载启动，即冷启动。​
      •​热启动：如果用户已经打开过某小程序，然后在一定时间内再次打开该小程序，此时小程序并未被销毁，只是从后台状态进入前台状态，这个过程就是热启动。​
    小程序没有重启的概念，所谓的重启即先主动销毁后再冷启动。小程序冷启动时会完整的触发小程序的生命周期函数。热启动时仅部分生命周期函数被触发。​
    ​

    ​前台状态和后台状态​

    首次打开小程序时候，小程序会处于前台运行状态。​
    点击右上角关闭按钮关闭小程序或者离开宿主客户端时，小程序并不会直接销毁，而是进入后台运行状态。小程序在后台停留超过 5 分钟会被主动销毁。​
    当未被系统销毁的小程序再度被打开或者激活时，会从后台运行切换为前台运行。​

    ​更新​

    小程序每次冷启动时，都会优先使用本地已经缓存的程序包启动小程序，同时异步检查是否有更新版本。​
    如果发现有新版本，将会异步下载新版本的代码包。因此新的代码包默认是在下一次冷启动时才会应用。如果需要在发布后马上应用最新版本，可以使用 getUpdateManager。​

    ​销毁​

    用户点击右上角的关闭按钮关闭小程序后，小程序仅是进入后台状态，并未被销毁。只有当小程序在后台状态下满足以下条件时，才会被销毁。​
      •​当小程序进入后台，可以维持一段时间（5 分钟）的后台运行状态，如果这段时间内都未再进入前台，小程序会被销毁。​
      •​当小程序占用系统资源过高，可能会被系统销毁或被客户端（头条、抖音或其它宿主）主动回收。​
    在 iOS 上，当客户端在一定时间间隔内连续收到系统内存告警时，会根据一定的策略，主动销毁小程序，并提示用户 「运行内存不足，请重新打开该小程序」。 建议小程序在必要时使用 tt.onMemoryWarning 监听内存告警事件，进行必要的内存清理。​

    ​JavaScript 支持情况​

    ​运行限制​

    基于安全考虑，小程序中不支持动态执行代码：​
      •​不支持 eval。​
      •​不支持 new Function() 创建函数。​
    小程序中禁止访问全局对象：​
      •​禁止访问globalThis。​
      •​禁止访问window。​

    ​ES6 支持情况一览表​

    抖音小程序很大程度上是支持 ES6 的，但是有少部分特性无法支持，目前的情况如下：​

    ​String​

    名称​
    iOS 9​
    iOS 10 及以上版本​
    Android​
    codePointAt​
    ✅​
    ✅​
    ✅​
    normalize​
    ❌​
    ✅​
    ✅​
    includes​
    ✅​
    ✅​
    ✅​
    startsWith​
    ✅​
    ✅​
    ✅​
    endsWith​
    ✅​
    ✅​
    ✅​
    repeat​
    ✅​
    ✅​
    ✅​
    String.fromCodePoint​
    ✅​
    ✅​
    ✅​

    ​Array​

    名称​
    iOS 9​
    iOS 10 及以上版本​
    Android​
    copyWithin​
    ✅​
    ✅​
    ✅​
    find​
    ✅​
    ✅​
    ✅​
    findIndex​
    ✅​
    ✅​
    ✅​
    fill​
    ✅​
    ✅​
    ✅​
    entries​
    ✅​
    ✅​
    ✅​
    keys​
    ✅​
    ✅​
    ✅​
    values​
    ✅​
    ✅​
    ✅​
    includes​
    ✅​
    ✅​
    ✅​
    Array.from​
    ✅​
    ✅​
    ✅​
    Array.of​
    ✅​
    ✅​
    ✅​

    ​Number​

    名称​
    iOS 9​
    iOS 10 及以上版本​
    Android​
    isFinite​
    ✅​
    ✅​
    ✅​
    isNaN​
    ✅​
    ✅​
    ✅​
    parseInt​
    ✅​
    ✅​
    ✅​
    parseFloat​
    ✅​
    ✅​
    ✅​
    Number.isInteger​
    ✅​
    ✅​
    ✅​
    Number.EPSILON​
    ✅​
    ✅​
    ✅​
    Number.isSafeInteger​
    ✅​
    ✅​
    ✅​

    ​Math​

    名称​
    iOS 9​
    iOS 10 及以上版本​
    Android​
    trunc​
    ✅​
    ✅​
    ✅​
    sign​
    ✅​
    ✅​
    ✅​
    cbrt​
    ✅​
    ✅​
    ✅​
    clz32​
    ✅​
    ✅​
    ✅​
    imul​
    ✅​
    ✅​
    ✅​
    fround​
    ✅​
    ✅​
    ✅​
    hypot​
    ✅​
    ✅​
    ✅​
    expm1​
    ✅​
    ✅​
    ✅​
    log1p​
    ✅​
    ✅​
    ✅​
    log10​
    ✅​
    ✅​
    ✅​
    log2​
    ✅​
    ✅​
    ✅​
    sinh​
    ✅​
    ✅​
    ✅​
    cosh​
    ✅​
    ✅​
    ✅​
    tanh​
    ✅​
    ✅​
    ✅​
    asinh​
    ✅​
    ✅​
    ✅​
    acosh​
    ✅​
    ✅​
    ✅​
    atanh​
    ✅​
    ✅​
    ✅​

    ​Object​

    名称​
    iOS 9​
    iOS 10 及以上版本​
    Android​
    is​
    ✅​
    ✅​
    ✅​
    assign​
    ✅​
    ✅​
    ✅​
    getOwnPropertyDescriptor​
    ✅​
    ✅​
    ✅​
    keys​
    ✅​
    ✅​
    ✅​
    getOwnPropertyNames​
    ✅​
    ✅​
    ✅​
    getOwnPropertySymbols​
    ✅​
    ✅​
    ✅​

    ​Other​

    名称​
    iOS 9​
    iOS 10 及以上版本​
    Android​
    Symbol​
    ✅​
    ✅​
    ✅​
    Set​
    ✅​
    ✅​
    ✅​
    Map​
    ✅​
    ✅​
    ✅​
    Proxy​
    ❌​
    ✅​
    ✅​
    Reflect​
    ✅​
    ✅​
    ✅​
    Promise​
    ✅​
    ✅​
    ✅​
    async/await​
    ✅​
    ✅​
    ✅​
    ​