开发
API

tt.env

从基础库 1.0.0 开始支持

环境变量。

属性说明

属性名类型默认值说明最低支持版本
VERSIONstring--表示当前的运行环境(具体参见下表)1.0.0
USER_DATA_PATHstringttfile://user用户数据存储的路径1.0.0

tt.env.VERSION 说明

表示当前的运行环境,枚举值如下:

属性名说明
production正式版
preview预览版
development开发版

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

【代码示例 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()
    let task = tt.downloadFile({
      url: "http://p3-tt.byteimg.com/large/pgc-image/S6q1kLv5kCgJSl?from=pc",
      success:(res) => {
        if (res.statusCode === 200) {
          console.log(`${res.tempFilePath}`);
          // 把下载到的临时地址,变成永久地址
          this.fileSystemManager.saveFile({
            tempFilePath: res.tempFilePath,
            // “本地用户文件”须以 tt.env.USER_DATA_PATH 开头
            filePath: `${tt.env.USER_DATA_PATH}/demo.jpeg`,
            success: (res) => {
              const savedFilePath = res.savedFilePath
              this.setData({
                filePath: savedFilePath
              })
              console.log('savedFilePath', 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 开头,否则容易出现访问受限的情况。
点击纠错
评价此篇文档