ドキュメント / トラブルシューティング
トラブルシューティング
問題が発生していますか?よくある問題の解決方法を以下にまとめています。各カードで、具体的な症状とその解決方法を説明しています。
権限
「BetterStageがウインドウを操作できない」
BetterStageがウインドウを読み取って移動するには、アクセシビリティの許可が必要です。システム設定 > プライバシーとセキュリティ > アクセシビリティを開き、BetterStageが一覧にあってオンになっていることを確認してください。すでにオンになっている場合は、一度オフにしてから再度オンにしてみてください。許可を変更したらBetterStageを再起動します。BetterStageの実行中に許可が取り消された場合は、アプリが警告を表示し、隠れていたウインドウを画面外に置いたままにせず元に戻します。アクセシビリティを取り消しても、BetterStageがキーボードやマウスの入力を保持し続けることはなくなりました。再度許可しても、実行中の保存されたワークスペース、自動復旧、スリープ解除時の復元が中断されることはありません。
「ショートカットが機能しない」
BetterStageのキーボードショートカットはネイティブのCarbonホットキーAPIを使っているため、入力監視の許可は必要ありません。ショートカットが機能しない場合は、まずアクセシビリティの許可がオンになっているか確認してください。また、他のアプリケーションが同じキーの組み合わせ、マウスボタン、トラックパッドジェスチャを使っていないかも確認してください。ショートカットが競合していると、BetterStageはイベントを受け取れません。キーボード、マウス、トラックパッドの操作は設定 > ショートカットで割り当て直せます。
「ウインドウが検出されない」
ウインドウの検出にはmacOSのアクセシビリティAPIを使っており、これはアクセシビリティの許可で利用できるようになります。システム設定 > プライバシーとセキュリティ > アクセシビリティでオンになっていることを確認してください。なお、一部のアプリケーションは標準外の種類のウインドウ(フローティングパネルや独自のChromeウインドウなど)を使っており、アクセシビリティAPIで検出できない場合があります。
ウインドウの動作
「BetterStageとmacOSのステージマネージャを一緒に使うべき?」
いいえ。BetterStageを使う前に、Apple内蔵のステージマネージャをオフにしてください。どちらもウインドウの表示を管理するため、同時に使うと予期しない切り替えが起きたり、ウインドウが隠れたり、間違った場所に表示されたりすることがあります。システム設定 > デスクトップとDock > ステージマネージャを開いてステージマネージャをオフにし、それでもワークスペースの表示がおかしい場合はBetterStageを再起動してください。
「Firefox/Chromeのウインドウが瞬時にスナップせず、アニメーションする」
一部のブラウザ(Firefox、Chrome、Electronベースのアプリ)は、AXEnhancedUserInterfaceというアクセシビリティのフラグをオンにしており、これによってウインドウの移動が瞬時のスナップではなくアニメーションになります。BetterStageは、該当するアプリでこのフラグを自動的に検出して無効にします。それでもアニメーションする場合は、ブラウザを終了して開き直し、BetterStageが修正を再適用できるようにしてください。
「Firefoxのウインドウがちらつく、思いどおりに配置できない、ステージの切り替えに遅れる」
Firefoxは標準外の方法でウインドウを扱うため、ウインドウ管理と常にうまく連携するとは限りません。ウインドウが一瞬ちらついたり、正確に配置できなかったり、ステージの切り替えに遅れたりすることがあります。これは既知の問題で、Firefoxとの互換性の改善を続けています。
「空のステージに切り替えるとFinderが表示される」
macOSは、最前面のアプリケーションに表示中のウインドウがないときにFinderをアクティブにすることがあります。BetterStage 2.2.0では、アプリケーション全体を隠すのではなく、個々のウインドウを専用の操作スペースに隠します。空のステージに予期せずウインドウが表示される場合は、アプリ名と、その現象が起きたステージやデスクトップの切り替えの手順をお知らせください。
「スリープやスクリーンセーバーの後、ウインドウが間違ったステージに移動した」
ディスプレイの配置が安定するまで待ってください。記憶されているディスプレイのレイアウトは自動的に戻ります。復旧のプロンプトが表示された場合は、「ワークスペースを復元」または「現在のレイアウトを維持」を選択します。デスクトップの削除後も隠れたままのウインドウや、ディスプレイの変更後に画面外に出てしまったウインドウには、メニューバーのウインドウをレスキューを使ってください。macOSの操作スペースを利用できないとBetterStageが報告した場合は、デスクトップの切り替えが終わるのを待ってから「再試行」を選択します。問題が続く場合はBetterStageを再起動してください。
「ダイアログやフローティングウインドウがTabStackの後ろに隠れてしまう」
スナップホイールを開き、「その他のアクション」からフローティングを前面に移動を選択します。レイアウトを変えたり隠れたタブを表示したりせずに、このモニター上のフローティングウインドウと管理対象外のウインドウを前面に移動します。「ウインドウをレスキュー」では、BetterStageが専用の操作スペースに隠したウインドウも復旧できます。元のデスクトップが削除されたウインドウも対象です。
「クラッシュ後にウインドウが見当たらない」
BetterStageは、専用の操作スペースに移動したウインドウを記録し、別の復旧用ヘルパーを実行しています。BetterStageが予期せず終了した場合、ヘルパーはその記録を使って、隠れていたウインドウを保存されたデスクトップに戻します。それでもウインドウが見当たらない場合は、BetterStageを再起動して「ウインドウをレスキュー」を使ってください。デスクトップが削除されていたり、ディスプレイの接続が外れていたりする場合は、移動できる代わりの移動先が必要になることがあります。
アプリの構成
「ターミナルからの実行と.appバンドルの違い」
ターミナルでswift runを使ってBetterStageを実行すると、macOSはアクセシビリティの許可をBetterStage自体ではなくターミナルアプリに付与します。BetterStageがシステム設定に名前で表示され、権限が正しく扱われるようにするには、代わりに.appバンドルをビルドして実行してください。
「ステージバーが表示されない」
ステージバーは、ホットエッジ(カーソルを画面上端に移動)またはキーボードショートカットOpt+Up Arrowで表示できます。設定でホットエッジがオンになっているか確認してください。それでもステージバーが表示されない場合は、BetterStageに必要なアクセシビリティの許可があるか確認してください。
ノッチのあるMacの内蔵ディスプレイでは、設定 > ステージ > ステージバー > ディスプレイのノッチを避けるを使うと、上端のノッチ部分だけを除外し、それ以外の部分は有効なままにできます。
「再接続後にモニターが認識されない」
BetterStageは、macOSが割り当てるディスプレイIDだけでなく、モデルやシリアル番号などのハードウェア情報でモニターを認識します。まれに、ドライバのアップデート後や、別のポートやアダプタを使った場合などに、これらの情報が変わることがあります。モニターの接続をいったん外して再接続し、BetterStageを再起動してみてください。それでもモニターが認識されない場合は、設定 > ディスプレイで設定し直してください。
「⌘TabでmacOSのアプリスイッチャーが表示される」
BetterStageの⌘Tab スイッチャーはオプションで、デフォルトではオフです。設定 > ⌘Tab スイッチャーでBetterStage の ⌘Tab を使うをオンにし、Pro、トライアル、または毎日のProプレビューが有効になっていることを確認してください。プレビューなしではアプリのアイコンが表示されます。ライブサムネイルを表示するには画面収録を許可してください。⌘Tab スイッチャーのガイドをご覧ください。
「2.0.xに戻したらステージが読み込まれない」
BetterStage 2.2で保存したステージは、それより前のバージョンでは開けません。2.0.xを再インストールした場合はステージが読み込まれないので、代わりにダウンロードページから最新バージョンにアップデートしてください。
バグの報告
BetterStageは、ディスクを圧迫しないよう上限10 MBで古い記録から上書きされる診断ログを保持しています。バグの報告に添付するには、メニューバーのBetterStageアイコンを開いて診断ログを表示…を選択します。Finderでログファイルが表示されるので、Discordのメッセージ、GitHubのIssue、メールにドラッグしてください。
リリースビルドでは、ウインドウタイトルが記録されるような詳細なログは出力しません。問題を再現していて、より詳しい記録が必要な場合は、Betaまたはリリース候補のビルドを実行してログを取得し、その後リリースチャンネルに戻してください。