Bereitstellung

Überblick#

Als Administrator legst du fest:

• welche Edition auf die Macs kommt und wie: der Direkt-Download über dein MDM oder Homebrew, oder die Mac-App-Store-Edition über Apple Business Manager,
• wie sie eingestellt ist: Lizenz, Modelle, Cloud-Verarbeitung, Downloads, Updates und Start über verwaltete Einstellungen,
• was sie darf und erreicht: Anmeldeobjekt, Berechtigungen und die Netzwerk-Hosts unten.

TypeWhisper braucht macOS 14 oder neuer und zum Ausführen keine Administratorrechte. Jeder Benutzer eines Mac hat eigene Einstellungen, Modelle und Plugins in seinem Benutzerordner. Ein Geräteprofil gilt für alle Benutzer, ein Benutzerprofil nur für diesen Benutzer.

Edition wählen#

Beide Editionen sind getrennte Apps mit getrennten Einstellungen; meist ist nur eine installiert. Apps-und-Bücher-Lizenzen enthalten keine In-App-Käufe. Für kommerzielle Lizenzschlüssel brauchst du daher den Direkt-Download.

Direkt-Download installieren#

Jedes Release enthält TypeWhisper-v<version>.dmg und eine ZIP-Datei. Die meisten MDMs installieren das DMG oder ein daraus erstelltes Paket; kopiere TypeWhisper.app nach /Applications (im Finder „Programme“). Die Dateien liegen auf der Release-Seite auf GitHub. Mit Homebrew:

brew install --cask typewhisper/tap/typewhisper

Zum Deinstallieren beendest du die App und löschst sie aus /Applications. Einstellungen, Modelle und Plugins bleiben im Benutzerordner erhalten; die Installationsseite nennt die Pfade für eine vollständige Bereinigung. Das Löschen der App deaktiviert eine verwaltete Lizenz nicht; entferne die Aktivierung in Polar.

Updates#

Der Direkt-Download aktualisiert sich mit Sparkle über https://typewhisper.github.io/typewhisper-mac/appcast.xml. Mit UpdateMode steuerst du das: 0 überlässt Updates deiner Softwareverteilung, 1 zeigt neue Versionen nur an, 2 installiert nur, wenn der Benutzer es startet. Unter 0 verteilst du neue Versionen mit deinem MDM.

Ein Update, das Sparkle vor einem strengeren UpdateMode schon für die automatische Installation geladen hat, kann beim Beenden von TypeWhisper noch installiert werden; Sparkle bietet keinen Weg, das abzubrechen. Verteile die Richtlinie deshalb zusammen mit der App.

Anmeldeobjekt#

macOS listet TypeWhisper unter Systemeinstellungen > Allgemein > Anmeldeobjekte & Erweiterungen. Dort können Benutzer es abschalten, auch wenn LaunchAtLogin erzwungen ist; TypeWhisper zeigt dann unter Einstellungen > Allgemein, dass das Anmeldeobjekt eine Freigabe braucht.

Um das Anmeldeobjekt freizugeben und zu sperren, verteilst du einen Service-Management-Payload (com.apple.servicemanagement, ab macOS 13, über MDM) mit einer Regel für die Team-ID 2D8ALY3LCL von TypeWhisper oder für die Bundle-ID. Das Beispiel für das Anmeldeobjekt deckt beide Editionen ab. Eine App, die nie gestartet wurde, kann ihr Anmeldeobjekt nicht registrieren: Starte TypeWhisper nach der Installation einmal.

Berechtigungen#

TypeWhisper fragt nach diesen Berechtigungen, sobald eine Funktion sie zum ersten Mal braucht. Ein Profil mit Datenschutzeinstellungen (PPPC, com.apple.TCC.configuration-profile-policy), das ein MDM ausliefert, kann einige davon vorab erteilen. Das Datenschutz-Beispiel enthält Einträge für Bedienungshilfen, PostEvent, Eingabeüberwachung und Bildschirmaufnahme. Erteile nur, was deine Funktionen und deine Edition brauchen. Kalender und Automation sind optional; ergänze ihre Einträge selbst, wenn du sie vorab erteilen willst.

Die Code-Anforderungen im Beispiel sind die Designated Requirements von TypeWhisper. So prüfst du sie an einer installierten App:

codesign -dr - /Applications/TypeWhisper.app

macOS wendet Datenschutzeinstellungen nur an, wenn ein MDM sie über eine automatisierte Geräteregistrierung oder eine vom Benutzer genehmigte MDM-Registrierung ausliefert. Ein von Hand installiertes Profil reicht dafür nicht.

Ab macOS 27: App-Einstellungen#

Ab macOS 27 ist der Eintrag Accessibility in einem PPPC-Profil veraltet, und die Systemeinstellungen nennen den Bereich „Gerätesteuerung und Datenzugriff“: macOS benachrichtigt den Benutzer und lässt ihn die Berechtigung dort abschalten. Apples Ersatz ist der Schlüssel Privacy der deklarativen Konfiguration für App-Einstellungen (com.apple.configuration.app.settings) für betreute Macs mit macOS 27 oder neuer. Er schlägt pro App Berechtigungen vor, erkannt an Bundle-ID und Code-Anforderung; der Benutzer bestätigt sie beim Start der App in einer einzigen Abfrage, zusammen mit der Begründung deiner Organisation. Vorschlagen lassen sich Bedienungshilfen, Mikrofon und lokales Netzwerk; still erteilt wird nichts.

• Das Beispiel für die App-Einstellungen schlägt Bedienungshilfen und Mikrofon für beide Editionen vor. Passe seine OrganizationJustification an.
• Die Abfrage nennt nur Berechtigungen, nach denen der Benutzer noch nicht gefragt wurde, und erscheint nicht mehr, wenn er alle schon gesehen hat. Verteile die Deklaration also, bevor Benutzer TypeWhisper zum ersten Mal starten.
• Liefere sie mit einem MDM aus, das deklarative Geräteverwaltung auf dem Benutzerkanal unterstützt, weil macOS den Schlüssel Privacy nur für Benutzer anwendet. Gib ihr bei jeder Änderung ein neues ServerToken, sonst behält der Mac die vorige Version; die meisten MDMs setzen das Token selbst.
• Behalte das Datenschutzprofil für ältere macOS-Versionen und für PostEvent, Eingabeüberwachung und Bildschirmaufnahme.

Netzwerk-Hosts#

Die App selbst kontaktiert diese Hosts über HTTPS und nutzt dabei die Proxy-Einstellungen des Systems:

Schaltet ein Benutzer die Verbindung für gekoppelte iPhones und iPads ein, lauscht TypeWhisper dafür im lokalen Netzwerk. Die HTTP-API lauscht nur auf der Loopback-Schnittstelle.

Cloud-Plugins kontaktieren ihren Anbieter. Die Tabelle nennt die Hosts der Plugins im Katalog, Stand TypeWhisper für Mac 1.8. Plugins mit dem Verarbeitungsort configurable erreichen den Endpunkt, Befehl oder Dienst, den der Benutzer einträgt.

Modelle und Plugins bereitstellen#

• TypeWhisper liest das Profil beim Start vor allem anderen. Ein Profil, das beim ersten Start vorhanden ist, gilt also sofort. Verteile einschränkende Profile vor der App oder zusammen mit ihr.
• Sind AllowModelDownloads oder AllowPluginDownloads abgeschaltet, können Benutzer Modelle oder Plugins nicht selbst laden. Modelle und Plugins liegen in ~/Library/Application Support jedes Benutzers: Lege sie dort ab, bevor die Einschränkung greift, oder erlaube Downloads für die erste Einrichtung. Kopiere nie Einstellungen oder Schlüsselbund-Einträge eines anderen Benutzers.
• Die Schlüssel steuern das Verhalten von TypeWhisper, nicht das Netzwerk. Kombiniere sie mit den Netzwerkkontrollen deines MDM, wo du stärkere Garantien brauchst.

Pilottest#

Prüfe vor dem Rollout auf einem verwalteten Mac mit dem Release, das du verteilst:

1. Verteile das Profil und starte TypeWhisper als Standardbenutzer. Einstellungen > Erweitert > Verwaltete Einstellungen listet die Werte, ohne ungültige Schlüssel und ohne Probleme mit Richtlinien.
2. Gesperrte Einstellungen zeigen „Von deiner Organisation verwaltet“, und abgelehnte Anbieter und Plugins nennen den Grund.
3. Diktiere einmal mit der vorgesehenen Engine und, falls genutzt, mit einem Workflow mit Sprachmodell.
4. Prüfe die Modelle, die deine Einrichtung braucht, besonders wenn Downloads abgeschaltet sind.
5. Ändere einen Wert im MDM und prüfe, dass die App ihn nach etwa 30 Sekunden ohne Neustart übernimmt. Entferne das Profil und prüfe, dass die eigenen Einstellungen des Benutzers zurückkehren.
6. Mit ManagedLicenseKey: Einstellungen > Lizenz zeigt den verwalteten Zustand und die Aktivierung. Starte TypeWhisper zweimal neu und prüfe, dass Polar keine zusätzlichen Aktivierungen zeigt. Wiederhole das mit einem zweiten Benutzer und mit einem ersten Start ohne Internet, gefolgt von „Aktivierung erneut versuchen“. Ersetze danach den Schlüssel, entferne ihn und vergleiche das Ergebnis mit dem Ablauf unter „Verwalteter Lizenzschlüssel“.
7. Starte den Mac neu und prüfe, dass Anmeldeobjekt, Mikrofon und die übrigen Berechtigungen sich wie vorgesehen verhalten.
8. Wiederhole die Prüfung mit der Mac-App-Store-Edition, wenn du sie verteilst.