forked from Blendman974/faceclaw
iOS porting: EvenHub app compatibility first pass
This commit is contained in:
1 parent
79b6c276f8
commit
44bd1d8a2d
24 files changed
+843
-24
No files matched your search
@@ -0,0 +1,53 @@
|
||||
# iOS config transfer
|
||||
|
||||
Requires Xcode, Python 3, a development build with `FaceclawConfigPort`, and an
|
||||
unlocked/trusted iPhone. Both commands restart Faceclaw, briefly interrupting its
|
||||
Bluetooth and Terminal sessions.
|
||||
|
||||
```sh
|
||||
scripts/pull_config_ios.sh # faceclaw_settings.ios.json
|
||||
scripts/push_config_ios.sh # import the edited file
|
||||
scripts/pull_config_ios.sh -f /tmp/settings.json --device IPHONE_UDID
|
||||
scripts/push_config_ios.sh faceclaw_settings.xml # Android pull_config.sh output
|
||||
```
|
||||
|
||||
Use `--device` / `-d` or set `IOS_DEVICE` when more than one device is connected.
|
||||
Without either, the script selects the only device with an active Xcode tunnel.
|
||||
For the simulator, add `--simulator` (defaults to `booted`; `--device` selects one).
|
||||
|
||||
The JSON format preserves setting types:
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": 1,
|
||||
"settings": {
|
||||
"terminal.connections": "[]",
|
||||
"terminal.autoReconnect": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Pull accepts an `.xml` output filename to write Android shared-preferences XML.
|
||||
Push detects JSON or XML by content and supports strings, booleans and numbers.
|
||||
Malformed input, unsupported values and files over 2 MiB fail before restarting
|
||||
the app. Push **merges supplied keys**, preserving omitted settings (including
|
||||
phone-specific pairing). To clear a value, supply its empty/default value.
|
||||
|
||||
Transfers use `devicectl` app-container access. The app consumes a uniquely
|
||||
identified request at bootstrap, before loading settings getters and workers;
|
||||
it applies imports through NSUserDefaults rather than overwriting a plist that
|
||||
cfprefsd could restore from cache. Each successful push first saves the previous
|
||||
preferences to `Library/FaceclawConfigPort/previous.plist`. Replies are checked
|
||||
against the request ID, so a stale export cannot appear to confirm an import.
|
||||
|
||||
Exports may contain API keys and Terminal tokens. Scripts do not print values,
|
||||
write local exports with mode 600, and remove their private temporary directory
|
||||
on exit. Default export filenames are gitignored. Device request/reply/backup
|
||||
files stay in the private Library directory, outside Files/Finder Documents.
|
||||
|
||||
Terminal's configured `g2mirror://` scheme uses plain WebSockets; `g2mirrors://`
|
||||
uses TLS. The iOS build declares local networking and an explicit ATS exception
|
||||
for the current development server `100.68.94.67`. On iOS 17+, another literal IP
|
||||
requires its own build-time `NSExceptionDomains` entry, or a TLS endpoint. The
|
||||
exception does not disable TLS certificate verification. See Apple's
|
||||
[IP exception rules](https://developer.apple.com/documentation/bundleresources/information-property-list/nsapptransportsecurity/nsexceptiondomains).
|
||||
Reference in new issue
Block a user