テキストエディター

テキストエディターは、デバイス側スクリプトのプロジェクトと通常のテキストファイルを編集するために使用します。開発プロジェクトを開いた後は、テストデバイスへ接続してスクリプトを直接実行、停止、デバッグし、暗号化した成果物や集中管理パッケージを生成することもできます。

テキストエディターを開く

主な開き方：

ファイルマネージャーでテキストファイルをダブルクリックするか、ファイルを右クリックしてテキストの編集を選択します。
デバイス一覧でデバイスを右クリックし、デバイス上のファイルを参照する項目を選択してから、デバイス上のテキストファイルを開きます。
開発ディレクトリ でプロジェクトフォルダーを右クリックし、プロジェクトを開く を選択してから、プロジェクトツリーでファイルをクリックします。
デバイス一覧でデバイスを右クリックし、短いスクリプトをすばやくテストするための一時 Lua ファイルを作成します。

よく使う編集操作

保存 をクリックして、現在の変更をファイルへ書き戻します。
再読み込み をクリックして、元の場所からファイル内容を再読み込みします。
タブを右クリックすると、ファイルマネージャーでの表示、名前変更、パスのコピーを行えます。
下部のステータスバーでは、行と列、インデント、エンコーディング、改行コード、ファイルの種類を確認できます。分からない場合は既定値のままでかまいません。
ミニマップボタンをクリックすると、右側のコードミニマップを表示または非表示にできます。

ファイルを開いた後に別の操作で変更された場合は、保存時に上書き確認が表示されます。再読み込みするときや、未保存のタブを閉じるときも、現在の変更が失われる可能性を示すメッセージが表示されます。

開発テストデバイスを設定する

オンラインで実行またはデバッグする前に、開発テストデバイスを設定する必要があります。デバイスはインポート済みでオンラインになっており、XXTouch から正常にアクセスできる必要があります。オフラインのデバイスでは、ファイルの参照、実行、デバッグはできません。

主な設定方法：

デバイス一覧で対象デバイスを右クリックし、開発テストデバイスとして設定 を選択します。
テキストエディターの左上にあるデバイスボタンをクリックし、テストデバイスを選択 を開いて対象デバイスを選択します。

設定後、テキストエディターに現在のテストデバイスが表示され、デバイス上のファイルを参照、サンプルワークベンチを開く、実行、停止、デバッグ などの操作を使用できます。

デバイスを変更する場合は、別のデバイスを選び直します。オンライン接続が不要になった場合は、同じ場所で テストを切断 をクリックします。

オンライン実行

開発プロジェクトまたはプロジェクト内のファイルを開いてから、実行 をクリックします。テキストエディターは、保存が必要な内容を先に保存し、現在のプロジェクトをテストデバイスへ送信して起動します。実行中の出力は、下部のログ領域で確認できます。

通常、実行できるのは開発プロジェクト内のスクリプトファイル、または直接実行可能な .lua ファイルです。通常のテキストファイル、認識されていないプロジェクト、エントリーポイントのないプロジェクトでは、現在のファイルは実行できません と表示されます。

主な状態：

実行中：スクリプトが起動済みか、デバイスでの実行を待っています。
停止中：停止リクエストをデバイスへ送信しています。
ログはまだありません：ログ接続は正常ですが、デバイスからの出力がまだありません。
開発デバイスを選択してください：テストデバイスがまだ設定されていません。
現在のファイルは実行できません：現在のタブが実行可能なプロジェクトに属していないか、認識可能なエントリーポイントがありません。
保存に失敗したため、実行を停止しました：現在のファイルを正常に保存できなかったため、実行を続行しません。

スクリプトを終了するには、停止 をクリックします。

オンラインデバッグ

デバッグ をクリックすると、プロジェクトをデバッグモードで起動できます。実行中の変数、コールスタック、分岐に関する問題を特定するのに適しています。

主な操作：

エディター左側の行番号領域でブレークポイントを設定または解除します。
続行、ステップオーバー、ステップイン、ステップアウト でスクリプトの実行を制御します。
コールスタックでスクリプトが停止している関数階層を確認します。項目をクリックすると、エディターが対応する位置へ移動します。
変数パネルで、現在の停止位置から参照できる変数を確認します。右クリックすると、変数値のコピーや変更ができます。
デバッグコンソールへ 1 行の Lua を入力し、スクリプトの一時停止中に式を実行します。
デバッグを切断 をクリックして、現在のデバッグ接続を終了します。

デバッグパネルには、未デバッグ、実行中、一時停止、デバッグ終了 などの状態が表示されます。デバッグに対応するプロジェクトとデバイスだけでデバッグを開始できます。現在のプロジェクトはデバッグできないと表示された場合は、まず通常実行を使用して、プロジェクトのエントリーポイントが正しいか確認してください。

プロジェクト設定

プロジェクトを開くと、テキストエディターのタイトルバーに プロジェクト設定 が表示されます。ここでは、プロジェクト名、プロジェクト ID、バージョン、説明、除外パス、共通ライブラリ、サンプルワークベンチの設定を管理できます。

プロジェクト設定を変更した後は 保存 をクリックします。スクリプト内容を編集するだけであれば、毎回プロジェクト設定を開く必要はありません。プロジェクト名、リリース情報、リソースパス、色取得設定を調整するときだけ開いてください。

プロジェクト成果物

テキストエディターのプロジェクト操作には、成果物を生成する次の機能もあります。

暗号化：配布またはデプロイに適した暗号化済み成果物を生成します。完了後に保存先が表示され、プロジェクトツリーまたはファイルマネージャーから表示・ダウンロードすることもできます。
集中管理パッケージ：集中管理サーバーのスクリプトディレクトリへインストールして管理できるスクリプトパッケージとして、プロジェクトをパッケージ化します。この操作は、パッケージ化に対応するプロジェクトの種類だけで使用できます。

成果物を生成する前に、開いているすべてのプロジェクトファイルを保存し、開発テストデバイスで一度実行して検証することを推奨します。

ボタンを使用できない場合は、通常、現在のタブがプロジェクトに属していない、プロジェクトの種類がその操作に対応していない、またはプロジェクトが操作可能な状態で保存されていないことが原因です。

AI 補完

AI 補完はテキストエディターの追加機能です。有効にすると、入力中に AI が生成したゴーストテキストの補完候補を表示できます。

使用するには、先にグローバル設定で次の設定を行います。

システム設定 → AI プロバイダー を開きます。
設定を追加 をクリックし、設定名、AI サービス、モデル、API Key を入力します。認証情報を必要としない互換サービスでは、API Key を空にできます。
モデル名を確認する場合は モデルを取得 をクリックするか、モデル名を手動で入力します。
システム設定 → テキストエディター を開きます。
AI 設定 で、作成した設定を選択します。
AI 補完 を有効にし、設定を保存 をクリックします。

有効にすると、対象となるテキストファイルへ入力しているときに、エディターが灰色の補完候補を自動的に表示します。主な操作：

Tab を押して現在の候補を受け入れます。
Esc を押して現在の候補を無視します。
Alt + Backslash を押して補完を手動で実行します。
複数の候補が表示された場合は、Alt + [ / Alt + ] で候補を切り替えます。

システム設定 → テキストエディター では、次のオプションも調整できます。

補完の設定：AI に従わせるコードスタイルやプロジェクトの規則を記述します。
対象ファイル拡張子：AI 補完を実行するファイルを制限し、独自の拡張子も追加できます。
補完コンテキスト：現在のファイルに加えて、XXTouch ドキュメント または プロジェクトファイル を含め、補完内容をスクリプトプロジェクトへより適合させられます。

補完が表示されない場合は、AI プロバイダー設定が追加済みか、AI 補完 が有効か、現在のファイル拡張子が対象範囲内か、モデル / API Key が利用可能かを確認してください。プロジェクトを開いた後にプロジェクトファイルへ大きな変更を加えた場合は、AI 補完コンテキストを更新 をクリックすると、現在のプロジェクト内容が再読み込みされます。