Documentazione / Risoluzione dei problemi
Risoluzione dei problemi
Hai un problema? Qui sotto trovi le soluzioni ai problemi più comuni. Ogni scheda descrive un sintomo specifico e come risolverlo.
Permessi
«BetterStage non riesce a controllare le mie finestre»
BetterStage richiede il permesso Accessibilità per leggere e spostare le finestre. Apri Impostazioni di Sistema > Privacy e sicurezza > Accessibilità e verifica che BetterStage sia in elenco e attivo. Se era già attivo, prova a disattivarlo e riattivarlo. Dopo aver modificato il permesso, riavvia BetterStage. Se il permesso viene revocato mentre BetterStage è in esecuzione, l'app ti avvisa e ripristina le finestre nascoste invece di lasciarle fuori dallo schermo. Revocare l'accesso ad Accessibilità non permette più a BetterStage di trattenere l'input di tastiera o mouse. Concederlo di nuovo non interrompe un ripristino in corso di uno spazio di lavoro salvato, della continuità o dopo il risveglio.
«Le scorciatoie non funzionano»
BetterStage usa l'API nativa Carbon per le scorciatoie da tastiera, quindi non serve il permesso Monitoraggio input. Se le scorciatoie non funzionano, verifica prima che il permesso Accessibilità sia attivo. Controlla anche che nessun'altra applicazione usi le stesse combinazioni di tasti, pulsanti del mouse o gesti del trackpad — le scorciatoie in conflitto impediscono a BetterStage di ricevere gli eventi. Riassegna i controlli di tastiera, mouse e trackpad in Impostazioni > Scorciatoie.
«Le finestre non vengono rilevate»
Il rilevamento delle finestre usa l'API Accessibilità di macOS, coperta dal permesso Accessibilità. Verifica che sia attivo in Impostazioni di Sistema > Privacy e sicurezza > Accessibilità. Tieni presente che alcune applicazioni usano tipi di finestra non standard (come pannelli flottanti o finestre personalizzate di Chrome) che l'API Accessibilità potrebbe non rilevare.
Comportamento delle finestre
«Posso usare BetterStage insieme a Stage Manager di macOS?»
No. Disattiva Stage Manager, la funzione integrata di Apple, prima di usare BetterStage. Entrambi gli strumenti gestiscono la visibilità delle finestre, quindi usarli insieme può causare cambi confusi, finestre nascoste o finestre che compaiono nel posto sbagliato. Apri Impostazioni di Sistema > Scrivania e Dock > Stage Manager e disattiva Stage Manager, poi riavvia BetterStage se lo spazio di lavoro sembra ancora sbagliato.
«Le finestre di Firefox/Chrome si animano invece di agganciarsi all'istante»
Alcuni browser (Firefox, Chrome e le app basate su Electron) attivano un flag di accessibilità chiamato AXEnhancedUserInterface che fa animare gli spostamenti delle finestre invece di agganciarle subito. BetterStage rileva e disattiva automaticamente questo flag per le app interessate. Se vedi ancora spostamenti animati, prova a chiudere e riaprire il browser, così BetterStage può riapplicare la correzione.
«Le finestre di Firefox lampeggiano, non si posizionano bene o restano indietro nei cambi di Stage»
Firefox gestisce le sue finestre in modo non standard, quindi non sempre collabora con la gestione delle finestre — potresti vedere finestre che lampeggiano brevemente, che non si lasciano posizionare con precisione o che restano indietro nei cambi di Stage. È un problema noto e continuiamo a migliorare la compatibilità con Firefox.
«Il Finder compare quando passo a uno Stage vuoto»
macOS può attivare il Finder quando l'applicazione in primo piano non ha finestre visibili. BetterStage 2.2.0 nasconde le singole finestre in uno Spazio privato invece di nascondere l'intera applicazione. Se una finestra compare inaspettatamente in uno Stage vuoto, segnalaci il nome dell'app e la sequenza di cambi di Stage o di scrivania che l'ha provocata.
«Le finestre sono finite nello Stage sbagliato dopo lo stop o il salvaschermo»
Attendi che la disposizione dei display si stabilizzi. Il layout di un display già noto torna da solo; se compare una richiesta di recupero, scegli Ripristina lo spazio di lavoro o Mantieni il layout corrente. Per le finestre che restano nascoste dopo la rimozione di una scrivania, o che sono finite fuori dallo schermo dopo una modifica ai display, usa Recupera finestre dalla barra dei menu. Se BetterStage segnala che gli Spaces di macOS non sono disponibili, completa il cambio di scrivania e scegli Riprova. Se il problema persiste, riavvia BetterStage.
«Una finestra di dialogo o una finestra flottante è bloccata dietro TabStack»
Apri la Ruota Snap e scegli Porta in primo piano le finestre flottanti da Altre azioni. In questo modo le finestre flottanti e non gestite di questo monitor vengono portate in primo piano senza modificare il layout né mostrare le schede nascoste. Recupera finestre recupera anche le finestre che BetterStage ha nascosto in Spaces privati, comprese quelle la cui scrivania originale è stata rimossa.
«Mancano delle finestre dopo un crash»
BetterStage registra le finestre spostate in Spaces privati ed esegue un processo di recupero separato. Se BetterStage si chiude in modo imprevisto, il processo di recupero usa queste registrazioni per riportare le finestre nascoste sulle loro scrivanie salvate. Se mancano ancora delle finestre, riavvia BetterStage e usa Recupera finestre. Una scrivania rimossa o un display scollegato potrebbero richiedere una destinazione sostitutiva raggiungibile.
Configurazione dell'app
«Esecuzione dal terminale o dal bundle .app»
Quando esegui BetterStage con swift run in un terminale, macOS associa il permesso Accessibilità alla tua app di terminale invece che a BetterStage. Per una gestione corretta dei permessi, con BetterStage elencato per nome in Impostazioni di Sistema, compila ed esegui invece il bundle .app.
«La barra degli Stage non compare»
La barra degli Stage si apre tramite il bordo attivo (spostando il cursore nella parte superiore dello schermo) o con la scorciatoia da tastiera Opt+Up Arrow. Verifica che il bordo attivo sia abilitato nelle Impostazioni. Se la barra degli Stage continua a non comparire, controlla che BetterStage abbia il permesso Accessibilità necessario.
Sui display integrati dei Mac con il notch, Impostazioni > Stage > Barra degli Stage > Evita il notch del display può escludere il notch mantenendo attivo il resto del bordo superiore.
«Il monitor non viene riconosciuto dopo il ricollegamento»
BetterStage riconosce i monitor dai dati hardware, come modello e numero di serie, non solo dall'ID del display assegnato da macOS. In rari casi, ad esempio dopo l'aggiornamento di un driver o con una porta o un adattatore diversi, questi dati cambiano. Prova a scollegare e ricollegare il monitor, poi riavvia BetterStage. Se il monitor continua a non essere riconosciuto, configuralo di nuovo in Impostazioni > Display.
«⌘Tab mostra ancora il selettore di app di macOS»
Il Selettore ⌘Tab di BetterStage è facoltativo e disattivato per impostazione predefinita. Attiva Usa ⌘Tab di BetterStage in Impostazioni > Selettore ⌘Tab e verifica che sia attivo Pro, la prova o un'anteprima giornaliera di Pro. Senza anteprime mostra le icone delle app; consenti Registrazione schermo per le miniature dal vivo. Consulta la guida al Selettore ⌘Tab.
«I miei Stage non si caricano dopo essere tornato alla 2.0.x»
Gli Stage salvati da BetterStage 2.2 non possono essere aperti dalle versioni precedenti. Se hai reinstallato la 2.0.x, i tuoi Stage non si caricheranno; aggiorna invece all'ultima versione dalla pagina di download.
Segnalare un bug
BetterStage conserva un log diagnostico a rotazione limitato a 10 MB, così non riempie mai il disco. Per allegarlo a una segnalazione di bug, apri l'icona di BetterStage nella barra dei menu e scegli Mostra log diagnostico… — il Finder si apre sul file di log, così puoi trascinarlo in un messaggio Discord, in una issue di GitHub o in un'email.
Le build di rilascio evitano i log dettagliati che registrerebbero i titoli delle finestre. Se stai riproducendo un problema e vuoi una traccia più completa, usa una build beta o release candidate, acquisisci il log e poi torna al canale di rilascio.
Ti serve ancora aiuto?
Se il tuo problema non è trattato qui sopra, contattaci e ti aiuteremo a risolverlo.