字節跳動開發者工具是專為小程序打造的開發者工具，字節跳動開發者工具能夠幫助用戶開發頭條小程序，為用戶提供了調試工具，代碼編輯，代碼檢測等工具。

使用方法

新建項目

當滿足：

已擁有一個字節跳動小程序的 AppID；

所登錄的賬號是該 AppID 所對應小程序的開發者。

可以選擇窗口中央的「創建一個頭條小程序」，或點擊右下角的「新建」按鈕，新建工程。

選擇項目類型：小程序或小游戲（一旦選擇無法更改）。

選擇一個空目錄，作為工程目錄。當選擇空目錄時，可以選擇是否在該目錄下生成一個簡單的項目。

appId 需要在公眾平臺管理后臺獲取。

主界面

圖中所示分別為：工具欄、模擬器、編輯器、調試器四大部分。

窗口菜單欄

小程序：可以查看開發者工具版本號

項目：支持打開「開發者工具」本身的調試器

編輯：可以查看編輯相關的操作和快捷鍵

工具欄

編譯：編譯當前的小程序項目

刷新頁面：刷新當前頁面

清除緩存：可以清除文件緩存、數據緩存、登錄狀態和授權數據

上傳：填入 app 版本號及

更新日志

，上傳小程序應用內容到服務器

預覽：生成二維碼，預覽已上傳版本

詳情：展示當前小程序的 appid、user_id、本地目錄、文件系統、基礎版本與編譯版本，并可以設置校驗 TLS 版本以及 HTTPS 證書

點擊「模擬器」、「編輯器」、「調試器」三個按鈕可以隱藏/顯示相應的模塊，界面中至少有一個模塊被顯示。

模擬器

模擬器模擬頭條小程序在客戶端真實的邏輯表現，對于絕大部分的 API 均能夠在模擬器上呈現出正確的狀態。開發者可以選擇不同的設備，調試小程序在不同尺寸機型上的適配問題。

編輯器

編輯器模塊內可以對當前項目進行代碼編寫和文件的添加、刪除以及重命名等基本操作。

文件格式：因 iOS 下僅支持 UTF8 編碼格式，最新版本的開發者工具會在上傳代碼時候對代碼文件做一次編碼格式校驗。

文件支持：工具目前提供了 5 種文件的編輯：ttml、ttss、js、json 以及圖片文件的預覽。

文件操作：可以通過在目錄樹上右鍵，選擇新建 Page，將自動生成頁面所需要的 ttml、ttss、js、json，及在 app.json 的 pages 字段，添加需要新建的頁面的路徑，將會自動生成該頁面所需要的文件，兩種方式新建頁面。

目錄樹：可以查看當前項目的目錄結構。

調試器

調試工具分為 6 大功能模塊：Bxml、Console、Sources、Network、Application、Performance

自定義編譯條件

編譯條件會讀取 project.config.json 中的 condition 字段下的相關配置，方便導入編譯條件。

點擊工具欄的普通編譯處，在下拉列表中，點擊添加編譯模式，會彈出填寫編譯條件窗口，添加自己的定制化的編譯條件。

在彈出的窗口中，添加模式名稱，啟動頁面，啟動參數以及進入場景幾個字段，點擊確認，生成新的編譯條件。

上傳提審

點擊工具欄的"上傳"按鈕，填寫版本號（版本號不能重復，需在上一個版本號上加 1）, 填寫

更新日志

，點擊確認上傳至開發者平臺。

上傳完成后，進入開發者平臺=》發布頁面進行提審

Bxml panel

Bxml panel 用于幫助開發者開發 ttml 轉化后的界面。在這里可以看到真實的頁面結構以及結構對應的 ttss 屬性，同時可以通過修改對應 ttss 屬性，在模擬器中實時看到修改的情況（僅為實時預覽，無法保存到文件）。通過調試模塊左上角的選擇器，還可以快速定位頁面中組件對應的 ttml 代碼。

Console panel

開發者可以在此調試代碼。

Sources panel

Sources panel 用于顯示當前項目的腳本文件，同瀏覽器開發不同，小程序框架會對腳本文件進行編譯的工作，所以在 Sources panel 中開發者看到的文件是經過處理之后的腳本文件，開發者的代碼都會被包裹在 define 函數中，并且對于 Page 代碼，在尾部會有 require 的主動調用。

Network panel

Network Panel 用于觀察和顯示 request 和 socket 的請求情況。

AppData panel

AppData panel 用于展示以及修改當前 page 的 data 屬性

Storage panel

可以查看 Storage 存儲情況。

常見問題

解決字節跳動開發者工具安裝無法打開問題

下載字節跳動開發者工具 下載之后 點擊安裝 默認安裝到

C:\Users\你的電腦名稱\AppData\Local\Programs\bytedanceide

目錄下 但是點擊打開 彈窗報紅色錯誤如下圖：

解決方法：

C:\Users\你的電腦名稱\AppData\Roaming 目錄下新建 bytedanceide 文件夾

然后 bytedanceide 文件夾下面新建 tmadevtool 文件夾

然后 tmadevtool 文件夾下面新建一個名為 projectInfo 的無后綴的文件

就這么輕松解決啦

重新打開字節跳動開發者工具 一切正常�。。�

更新日志

3.0.7

修復 windows 系統代碼無高亮問題

修真機調試多開窗口混亂的問題

修復清除緩存功能

修復登錄驗證碼太小導致不清晰的問題