025期特码资料:觸動精靈 IDE 腳本編輯器使用手冊

rourou ? 發表于 2018-09-03 19:01:41 ? 更新于 2019-08-22 16:48:49 ? 0回復

簡介

012期特码资料 www.aalov.icu 觸動精靈腳本編輯器(以下簡稱編輯器)是觸動精靈為廣大腳本開發者提供的一個電腦端的集成開發工具,具有腳本編輯、工程管理、函數補全、關鍵字高亮、函數庫高亮、腳本檢錯、工程打包、遠程導入、遠程運行、遠程調試、日志輸出等功能。

遠程運行和遠程調試功能需要授權觸動 iOS 普通版

下載軟件

下載地址://www.aalov.icu/tools
IDE 為綠色版本,解壓即可,無需安裝。

視頻教程

常見問題和注意事項

//v.youku.com/v_show/id_XMTgwNzY3NzAwNA==.html

函數調用堆棧

//v.youku.com/v_show/id_XMTM0NDQ5MzM1Ng==.html

使用說明

Access Key

首次使用編輯器時,需要輸入觸動精靈 TS Remote API 的 Access Key,目的是保證編輯器和觸動精靈客戶端的連接更穩定。
Access Key 可在觸動精靈開發者平臺獲取,注冊成功后可在個人中心-> Acess ?Key?中查看。

如何修改 key
在編輯器安裝路徑下找到 key.txt,替換文檔中的內容即可。
觸動精靈 IDE 腳本編輯器使用手冊

軟件界面

觸動精靈 IDE 腳本編輯器使用手冊

視圖操作

在主菜單中的視圖菜單中可以對編輯器的一些窗口進行打開/關閉操作,包含 文件管理、工程、設備管理、函數列表、輸出窗口等。

  1. 雙擊任意擴展窗口分頁空白處可激活該窗口的移動/拆分功能,可利用此功能自行對各功能窗口進行合理擺放。
  2. 輸出、本地控制臺、日志輸出,這三個窗口僅可以移動位置,不能進行拆分。
  3. 設備管理、函數列表窗口與工程窗口合并時關閉工程窗口將導致三個窗口一起關閉,初次使用請在視圖菜單中將工程窗口置于開啟狀態。

觸動精靈 IDE 腳本編輯器使用手冊函數視圖中會顯示當前打開的腳本文件中所有的函數列表

遠程設備管理

在快捷視圖的設備欄中我們可以對局域網中的遠程設備進行管理、這也是文件發送和遠程調試運行的必要前提。

  1. 在設備欄中的空白區域點擊鼠標右鍵,在快捷菜單中選擇搜索設備,所有在同一局域網中安裝過觸動精靈 iOS v2.1.7 或 Android v1.1.4 以上版本的設備將會出現在此窗口中。iOS設備以藍色圖標顯示,安卓設備以綠色圖標顯示,如有設備沒有正常出現在列表中可多次使用搜索設備功能進行搜索或者選擇菜單中的添加設備,手動輸入設備 IP 地址進行添加。
  2. 如遇不能添加設備的情況,可以在觸動精靈更多界面中檢查局域網廣播開關是否開啟、遠程設備與電腦是否在同一個網段、是否打開了多個編輯器窗口導致端口占用、電腦中的防火墻是否關閉、系統中是否安裝有虛擬網卡,這些因素都可能會導致添加設備失敗。
  3. 通過選中設備欄中已添加的設備,并點擊快捷工具欄中的連接設備按鈕可建立電腦與移動設備之間的通訊,連接成功后可對此設備進行文件發送、遠程運行、遠程調試、重啟、注銷等操作。

遠程設備文件管理

在快捷視圖設備欄中,雙擊設備可查看遠程設備的?TouchSprite?下的目錄結構及文件,右鍵點擊文件,在快捷菜單中選獲取文件可將該文件獲取到本地目錄、點擊刪除文件可將遠程設備上的該文件刪除。

  1. 可操作的目錄僅限于?TouchSprite\lua?TouchSprite\res?TouchSprite\log?TouchSprite\pluginTouchSprite\config。

控制臺操作說明

  1. 右鍵菜單 - 清除輸出窗口?清除當前窗口的輸出日志
  2. 輸出窗口?顯示設備連接狀態(成功與否)、腳本運行狀態
  3. 日志輸出?顯示腳本運行遠程日志(相關函數 nLog)
    觸動精靈 IDE 腳本編輯器使用手冊

創建工程

創建工程會在工程目錄創建一個工程文件夾,里面包含腳本主文件 main.lua、音頻圖片資源、其他工程文件等。
觸動精靈 IDE 腳本編輯器使用手冊

注意事項

觸動精靈工程默認保存在[TS Studio程序目錄]/workspace下,啟動程序后自動讀取工程顯示在左邊的工程樹中,可以通過文件菜單中設置工程路徑改變此默認路徑。

  1. 工程中的 ?main.lua 為腳本主文件,實際執行的腳本將最先加載此文件,不能刪除和重命名。
  2. 在工程名上單擊鼠標右鍵,可以對此工程進行的操作。
  3. 在工程中可以添加多個其他文件至工程中,系統將會對導入的文件進行自動分類,可導入工程的文件包含但不限于?*.lua?*.luac?*.png?*.jpg?*.bmp?*.so?*.dylib?*.txt,so 庫和 dylib 庫將直接歸入工程中的插件分類,除 lua 及 luac 以外的文件將直接歸入工程中的資源分類。
  4. 在工程鼠標右鍵快捷菜單中可以對整個工程進行壓縮打包,將會在你工程路徑根目錄中生成以工程名為文件名的 zip 包,此壓縮包可直接用于上傳開發者平臺使用。
  5. 在工程鼠標右鍵快捷菜單中可以將整個工程發送至移動設備,系統將根據工程的分類將其包含的文件自動傳送至移動設備對應目錄中,需要注意的是,使用此功能需先連接設備。

連接設備

注意:安卓需要登錄賬號并購買VIP,iOS 需要購買觸動授權,只能連接專業版或者標準版,無法連接企業版 。

  1. 在設備面板中右鍵,搜索設備或使用 IP 添加設備(設備和電腦需要在同一個 WiFi 下且觸動精靈服務開關及觸動精靈局域網廣播開關已打開)
    觸動精靈 IDE 腳本編輯器使用手冊當掃描不到設備的時候可以嘗試通過IP直接添加

觸動精靈 IDE 腳本編輯器使用手冊

  1. 連接到設備,查看輸出面板中是否提示設備連接成功
    觸動精靈 IDE 腳本編輯器使用手冊

連接安卓模擬器

注意:需要觸動精靈登錄賬號購買 VIP 才能連接。

第一種方法:

  1. 打開已安裝了觸動精靈安卓版的模擬器,請保證同時只有一個模擬器在運行,如果電腦已連接其他安卓設備請從電腦關閉。
  2. 在模擬器上運行觸動精靈 (獲取 root 權限) -> 打開服務 -> 打開局域網廣播
  3. 下載附件?ADB 模擬器連接 IDE 3.0.zip
  4. 解壓縮下載好的壓縮文件,運行?連接編輯器.bat?可以連接模擬器
  5. 打開 IDE 新增設備,新增設備輸入?IP:127.0.0.1,點擊連接
  6. 連接成功后有提示文字,如果要查看 nLog 日志請運行?顯示nLog日志.bat

注意事項

模擬器關閉后連接設置將失效,每次重啟模擬器后需要重新設置連接。

第二種方法:
如果 v5.2(6.0)以上版本神模擬器連接不成功,可以換夜神 v3.8.3.1 版本再嘗試連接,或者運行 cmd 在 ADB_IDE 連接模擬器目錄路徑下(譬如:C://ADB_IDE 連接模擬器目錄下執行)
開始中搜索 cmd
觸動精靈 IDE 腳本編輯器使用手冊?打開 cmd 之后輸入 cd+adb 所在目錄地址后回車
觸動精靈 IDE 腳本編輯器使用手冊執行 adb 命令 adb connect 127.0.0.1:62001 再次回車連接模擬器

第三種方法:
觸動精靈 IDE 腳本編輯器使用手冊

雷電/夜神模擬器設置局域網的方法: 打開模擬器后點擊設置 ->點擊網絡設置->開啟網絡橋連->IP 設置選擇 DHC->安裝驅動->點擊保存設置->重啟模擬器。

觸動精靈 IDE 腳本編輯器使用手冊

輸入雷電模擬器顯示的 IP 即可連接 IDE 及抓色器。

USB 連接蘋果手機

首先確保你的手機上已經安裝了觸動精靈 iOS 客戶端,然后下載附件中的文件,按照教程進行設置即可。
附件下載?iOS 的觸動 USB 端口監聽.zip

使用方法:

將 iOS 設備用數據線與電腦連接,并確保電腦上已經安裝 iTunes(可下載 iTools,只要能識別到手機即可)

  1. 解壓附件,運行其中的?開始USB監聽.bat?文件
  2. 如果窗口中出現?[INFO]Device connected:設備號?字樣,代表監聽成功。注意圖中顯示的設備號為 UDID,并不是觸動精靈的設備號。
    觸動精靈 IDE 腳本編輯器使用手冊
  3. 打開 IDE,在設備面板中輸入?127.0.0.1?添加設備
    觸動精靈 IDE 腳本編輯器使用手冊
  4. 右鍵選擇連接設備,在輸出面板中看到連接成功的提示就成功了
    觸動精靈 IDE 腳本編輯器使用手冊

注意事項
如果運行監聽文件一閃而過或者一直失敗,請按照教程中的方法修改注冊表。

連接設備報錯

  1. 檢查是否購買了觸動授權,iOS需要購買觸動授權,安卓需要登錄賬號購買 VIP。
  2. 檢查編輯器輸入的 Access Key 是否正確(登錄開發者平臺在個人中心-> Access Key 中查看)
  3. 檢查編輯器所在電腦和設備是否在同一 WiFi 網絡下,是否能 ping 通
  4. 檢查設備上的觸動精靈服務和廣播開關是否為開啟狀態
  5. 檢查電腦上是否開啟了 VPN 或其他代理服務,如果是,請關掉并去掉代理
  6. 重啟設備上的觸動服務和廣播開關
  7. 重啟路由器
  8. 刪掉編輯器,從壓縮包中重新解壓到桌面或系統盤根目錄

遠程調試

  1. 在工程面板中右鍵?發送工程到設備,會將當前工程文件夾下的腳本和資源文件都發送到設備
    觸動精靈 IDE 腳本編輯器使用手冊
  2. 打開腳本主文件,點擊菜單欄中的?開始/繼續遠程運行該文件(Alt + R)
    觸動精靈 IDE 腳本編輯器使用手冊
  3. 腳本中的 nLog 輸出在左下方日志輸出面板中
    觸動精靈 IDE 腳本編輯器使用手冊

nLog 不輸出日志

  1. 打開電腦任務管理器,在進程中找到 lua.exe,關,,再次運行腳本嘗試
  2. 關閉電腦的防火墻再次嘗試
  3. 如果開啟了虛擬網卡,關閉后再次嘗試

編輯器左側欄不顯示中文函數

在中文函數前面加任意英文字母即可。
觸動精靈 IDE 腳本編輯器使用手冊

工程打包

在工程視圖中選中要打包的工程,在右鍵菜單中選擇工程打包,會在工程文件夾同級目錄下生成一個 zip 包。
工程文件夾下的腳本和資源文件都會包含在 zip 包中。
觸動精靈 IDE 腳本編輯器使用手冊

觸動精靈 IDE 腳本編輯器使用手冊

一個包含腳本文件、擴展庫文件和資源文件的工程

打包失敗

如果遇到無論如何都打包不成功的情況,可備份工程文件、刪除編輯器、重新解壓再嘗試。

注意事項

很多人使用綠色三角按鈕的調試功能會提示需要觸動精靈授權,在此提示,不建議大家使用這個功能,請使用后面帶電腦標志的調試(需要先連接設備)。

  1. 如果設備和編輯器連接不成功,請嘗試開關觸動精靈服務、重啟編輯器、重啟路由,但是最重要的是,確保你的手機和電腦在同一個無線網下。
  2. 如果本地打開了 VPN 或其他代理工具,請關閉后再使用編輯器的腳本調試功能。
  3. 觸動精靈 iOS 腳本路徑為 /var/mobile/Media/TouchSprite/lua
  4. 觸動精靈 Android 腳本路徑為 /sdcard/TouchSprite/lua

自定義界面

打開編輯 - 首選項 - 用戶配置 即可即時調整配色方案

自定義配色方案

打開編輯器目錄下?cfg\tomorrow.lua?編輯?custom?表里的具體對應顏色,保存后在編輯 - 首選項 - 用戶配置 選擇?custom?方案即可

觸動精靈 IDE 腳本編輯器使用手冊當前版本提供的配色方案:

Tomorrow
TomorrowContrast
TomorrowNight
TomorrowNightEighties
TomorrowNightBlue
TomorrowNightBright
Zenburn
Monokai
TouchSprite
Molokai
SolarizedDark
SolarizedLight
NotepadPlusPlus
SciTeLuaIDE

觸動精靈 IDE 腳本編輯器使用手冊

改變字體

打開觸動精靈編輯器的配置文件 \cfg\user.lua,找到下面的文字(約 24 行)

  1. editor.fontname = "Courier New"

觸動精靈 IDE 腳本編輯器使用手冊
將 "Courier New" 改成電腦系統已有的字體
例如改成

  1. editor.fontname = "Arial"

保存后,重啟編輯器就可以了

觸動精靈腳本格式

二進制腳本 - TSP

  1. TSP 為觸動精靈獨有腳本格式,僅能被觸動精靈識別,此格式由觸動精靈開發者平臺生成。
  2. 將你的腳本工程打包為 zip 格式,并上傳至開發者平臺,即可生成 TSP 格式的腳本。
  3. TSP 腳本為一個單獨文件,里面包含了你的所有腳本文件,圖片、音頻、文本等資源及一些腳本基本信息。
  4. TSP 格式為加密格式,需聯網驗證,無法查看和修改腳本的源代碼。
  5. TSP 運行時將會釋放里面包含的資源文件,需要注意的是,在觸動精靈iOS v2.2.0 以上版本中,圖片資源每次運行都會釋放至?/User/Media/TouchSprite/res/?目錄,如目錄中存在同名文件,將進行覆蓋操作。

明文格式腳本 - lua

  1. 明文腳本一般以 lua 為擴展名,為文本格式,可以用任意文本編輯器打開編輯。
  2. 觸動精靈中錄制所產生的腳本即為明文腳本。
  3. 可將明文腳本文件在編輯器中打開進行編輯,并打包上傳至開發者平臺生成加密的二進制腳本。

常用快捷鍵

  • 調試運行?F6
    本地代碼運行,不支持運行包含觸動精靈擴展函數的代碼
  • Alt + S
    發送文件到設備,需先在左側項目列表中選中需要發送的文件(支持 CTRL 多?。?,發送文件格式支持 lua、luac、txt,使用此功能前需要先連接設備
  • Alt + R
    將當前腳本傳至設備上并運行,使用此功能遠程運行腳本不會出現運行提示框,此功能需先連接設備
  • F7
    對當前代碼進行二進制編譯,生成的文件路徑會在輸出窗口提示
  • Shift + F7
    代碼檢查,可檢查是否有語法錯誤,可在輸出欄直接雙擊錯誤提示跳轉到對應行
  • F9
    在當前光標行設置斷點,在遠程調試中使用
  • F10
    單步運行跟蹤,在遠程調試中使用
  • Ctrl + Shift + D
    開始/繼續 遠程調試,在遠程調試中使用
  • Shift + F5
    終止遠程調試中的腳本運行
  • Ctrl + Shift + W
    打開/關閉 監視窗口,用于遠程調試
  • Ctrl + Shift + S
    打開/關閉 調用堆棧窗口,用于遠程調試

腳本編輯

  • Ctrl + Shift + p

打開/關閉 文件管理窗口

  • F12
    對整個代碼進行折疊,再按一次取消折疊
  • Ctrl + I
    一鍵自動縮進,可對當前代碼進行智能縮進排版
  • Ctrl + D
    快速復制當前行,以當前光標為準
  • Ctrl + C
    快速復制當前行到剪貼板
  • Ctrl + V
    黏貼剪貼板內容到光標位置
  • Ctrl + U
    代碼注釋,對已經注釋的代碼使用會取消注釋
  • Ctrl + B
    打開快捷操作欄,可用來快速檢索內容,如:直接輸入字符可直接在整個項目目錄搜索對應內容打開并顯示在當前窗口
  • Ctrl + G
    可通過輸入行號快速跳轉到指定行
  • Ctrl + F2
    對光標所在行設置標簽,用于不同行之間的快速跳轉
  • F2
    跳轉至下一個標簽行,需先設置標簽
  • Shift + F2
    跳轉到上一個標簽行,需先設置標簽
  • Ctrl + F
    搜索替換
  • Ctrl + F
    在當前代碼中搜索
  • Ctrl + Shift + F
    在文件中進行搜索、支持多級子目錄、支持搜索結果上下文顯示,在搜索結果中雙擊可自動打開對應文件并跳轉至對應行
  • Ctrl + "+"
    對顯示字體進行放大
  • Ctrl + "-"
    對顯示字體進行縮小
  • Ctrl + 0
    還原字體大小為默認

附錄

觸動精靈腳本開發指南

新手必讀,最全面的腳本開發必備常識、視頻教程、開發工具://www.aalov.icu/docs/4945

已知與觸動精靈沖突的插件列表

showUI 不能彈出、點擊沒反應、滑動失效等問題有可能是由于安裝了沖突插件引起的
//www.aalov.icu/docs/536

設備 SSH 連接工具

WinSCP:https://pan.baidu.com/s/1del626?密碼:wdcn

簡體中文語言包:https://pan.baidu.com/s/1dmYZL0?密碼:jd9z

Putty:https://pan.baidu.com/s/1pMwHRUN?密碼:pegn

相關工具運行庫

VCredist 2010:https://pan.baidu.com/s/1cSap22?密碼:mchk

NET Framework 4://www.microsoft.com/zh-cn/download/details.aspx?id=17718

OCR(光學字符識別)相關

觸動精靈本地OCR簡體中文識別庫:https://pan.baidu.com/s/1snhuZyH?密碼:hy56

觸動精靈本地OCR英文數字識別庫:https://pan.baidu.com/s/1pMbdlEV?密碼:9ewt

4 人覺得有幫助 有幫助