Skip to content

Tips

Jump to bottom
dynamis edited this page Dec 26, 2021 · 9 revisions

Amethyst Tips

UI と基本操作

Amethyst は Firefox ブラウザーのヘビーな UI (Chrome) 部分無しで Web コンテンツをロードできる WebViewer のサンプル実装であり、基本的な UI と感じるものでもブラウザとして実装する機能や UI は原則一切ありません。

但し、テスト、開発上の効率化のために必要性が高い「戻る」機能については、キーボードのバックスペースキーで利用できるようにしています。

その他のショートカットキーも要望があれば、読み込みコードの量が増えてメモリや CPU への負荷が増えずに済む範囲に限り対応しています。誤って終了できてしまうのは不味いので、終了用のショートカットキーなどはデフォルト無効としています。
対応済みショートカットキーについてはこちらを参照
Keyboard shortcut

テストしたいページはコマンドライン引数で URL を指定して開きます。URL の http:// などプロトコル名部分は省略しても読み込めるので、キー入力数を節約できます。

UI を削除しているといっても通信起動で開くメインウインドウで読み込まれる範囲のみで、他のウインドウや内部設定ページなどはコマンドライン引数で about:preferences や about:config や about:support などのように各種画面の URL を指定して読み込めば Firefox 同様に使えるので、上手に活用してください。

起動した Amethyst の終了は Ctrl+Alt+F1 と Ctrl+Alt+F2 などで仮想端末 (ターミナル/デスクトップ) を切り替えて、ターミナルからプロセスを kill してください。

開発、デバッグ時の注意

PC からの リモートデバッグ が基本です。忘れやすいポイントなど列挙します。

  • 実機側のコマンドラインで --start-debugger-server を指定しないとリモートデバッグできません
  • PC 側の Firefox は実機のバージョンに合わせてください
  • メインスレッドからコンテンツに切り替えたら二度とデバッグターゲットフレーム切り替えボタンには触れないでください。フリーズします！
  • コンテンツは実機ローカルからでも読み込めますが、開発時は PC 側にサーバをたてて実機から読み込ませる想定です。実機側の操作性が低いのでライブ・リロードに対応したフレームワークでの開発を推奨します
  • ライブ・リロードを使わない場合でも、リモートデバッグ接続したら PC 側の開発ツール画面で Ctrl+R で実機側をリロードできます。Firefox 開発ツールのデバッグ対象を操作する機能も有効利用してください

デフォルト設定は製品採用時に近くする想定ですが、開発者が多い場合などはビルド担当者がビルド時に開発用の設定を入れたりしてからコンテンツ開発担当者に渡すなどしてください。

プロファイルと設定について

Amethyst でも Firefox と同様に about:preferences を開くことで GUI 画面で内部設定の変更が可能です。ここで変更した設定はプロファイルディレクトリ (${HOME}/.mozilla/firefox/ や ${HOME}/.renesas/webviewer/ など) の prefs.js ファイルに記載されています。

起動しなくなってしまった場合

最初は起動していたのに起動しなくなった場合、Firefox 同様プロファイルに書き込まれている設定やデータなどが原因となっていることが多いです。その場合、次のいくつかの方法で原因を取り除くことが出来ます。

  • ユーザー設定を書き換える
    • プロファイルディレクトリの prefs.js に設定が JavaScript のコードとして書き込まれているので、エディタで書き換えてから起動し直してください
  • セーフモードで起動する
    • 拡張機能が原因の場合などは firefox --safe-mode で拡張機能を一時的に無効化して起動することも出来ます
  • プロファイルを新しくする
    • firefox -P でプロファイルマネージャを起動し、新規プロファイルの作成やデフォルトプロファイルの切り替えが可能です
    • 但し、新規プロファイルでの初回起動時にフリーズする場合があります。その場合は再度起動し直してください。
  • プロファイルディレクトリごとすべて削除する
    • ${HOME}/.mozilla 等のディレクトリをまるごと削除してから起動すると、初期設定のプロファイルディレクトリが自動的に作成されます
    • 但し、新規プロファイルでの初回起動時にフリーズする場合があります。その場合は再度起動し直してください。

Clone this wiki locally