tt.env
收藏
我的收藏

从基础库 1.0.0 开始支持。

警告

此接口将逐步废弃，请切换使用 tt.getEnvInfoSync。请及时修改下线，避免影响小程序使用。

环境变量。

属性

属性名	类型	说明	最低支持版本
VERSION	string	表示当前的运行环境（具体参见下表）	1.0.0
USER_DATA_PATH	string	用户数据存储的路径	1.0.0

VERSION 枚举值

值	说明	最低支持版本
production	正式版	1.0.0
preview	预览版	1.0.0
development	开发版	1.0.0

扫码体验

代码示例

开发者工具中预览

【代码示例 1】VERSION 的用法。

// 正式版情况下
// production
console.log(tt.env.VERSION);
// 预览版情况下
// preview
console.log(tt.env.VERSION);
// 开发版情况下
// development
console.log(tt.env.VERSION);

【代码示例 2】使用 USER_DATA_PATH，下载图片到本地。

<view>
  <progress percent="{{progress}}" />
  <image tt:if="{{filePath}}" src="{{filePath}}" mode="aspectFit"></image>
  <button tt:else type="primary" bindtap="downloadImage">选择图片</button>
</view>

Page({
  data: {
    filePath: "",
    progress: 0,
  },

  downloadFile() {
    // 获取 fileSystemManager
    this.fileSystemManager = tt.getFileSystemManager();

    const task = tt.downloadFile({
      url: "http://p3-tt.byteimg.com/large/pgc-image/S6q1kLv5kCgJSl?from=pc",

      success: (res) => {
        if (res.statusCode === 200) {
          // 把下载到的临时地址，变成永久地址
          this.fileSystemManager.saveFile({
            tempFilePath: res.tempFilePath,
            // “本地用户文件”须以 tt.env.USER_DATA_PATH 开头
            filePath: `${tt.env.USER_DATA_PATH}/demo.jpeg`,
            success: (res) => {
              this.setData({
                filePath: res.savedFilePath,
              });
            },
            fail(res) {
              console.log("error", res);
            },
          });
        }
      },

      fail(res) {
        console.log(`downloadFile调用失败`);
      },
    });

    task.onProgressUpdate((res) => {
      this.setData({
        progress: res.progress,
      });
    });
  },
});

Bug & Tip

•

Tip：访问本地目录或者本地文件时，需要以 tt.env.USER_DATA_PATH 开头，否则容易出现访问受限的情况。

tt.env收藏我的收藏

属性

VERSION 枚举值

扫码体验

代码示例

Bug & Tip

tt.env
收藏
我的收藏