Files
SideStore/SideStore/MinimuxerWrapper.swift
2026-03-03 04:33:07 +05:30

274 lines
11 KiB
Swift

//
// MinimuxerWrapper.swift
//
// Created by Magesh K on 22/02/26.
// Copyright © 2026 SideStore. All rights reserved.
//
import Foundation
import Minimuxer
func bindTunnelConfig() {
defer { print("[SideStore] bindTunnelConfig() completed") }
#if targetEnvironment(simulator)
print("[SideStore] bindTunnelConfig() is no-op on simulator")
#else
print("[SideStore] bindTunnelConfig() invoked")
Task { @MainActor in
let config = TunnelConfig.shared
Minimuxer.bindTunnelConfig(
TunnelConfigBinding(
setDeviceIP: { value in Task { @MainActor in config.deviceIP = value } },
setFakeIP: { value in Task { @MainActor in config.fakeIP = value } },
setSubnetMask: { value in Task { @MainActor in config.subnetMask = value } },
getOverrideFakeIP: { config.overrideFakeIP },
setOverrideEffective: { value in Task { @MainActor in config.overrideEffective = value } }
)
)
}
#endif
}
var isMinimuxerReady: Bool {
var result = true
#if targetEnvironment(simulator)
print("[SideStore] isMinimuxerReady = true on simulator")
#else
result = Minimuxer.ready()
print("[SideStore] isMinimuxerReady = \(result)")
#endif
return result
}
func retargetUsbmuxdAddr() {
defer { print("[SideStore] retargetUsbmuxdAddr() completed") }
#if targetEnvironment(simulator)
print("[SideStore] retargetUsbmuxdAddr() is no-op on simulator")
#else
print("[SideStore] retargetUsbmuxdAddr() invoked")
Minimuxer.retargetUsbmuxdAddr()
#endif
}
func minimuxerStartWithLogger(_ pairingFile: String, _ logPath: String, _ loggingEnabled: Bool) throws {
defer { print("[SideStore] minimuxerStartWithLogger(pairingFile, logPath, dest, loggingEnabled) completed") }
#if targetEnvironment(simulator)
print("[SideStore] minimuxerStartWithLogger(pairingFile, logPath, loggingEnabled) is no-op on simulator")
#else
// refresh config if any
bindTunnelConfig()
// observe network route changes (and update device endpoint from vpn(utun))
NetworkObserver.shared.start()
print("[SideStore] minimuxerStartWithLogger(pairingFile, logPath, dest, loggingEnabled) invoked")
try Minimuxer.startWithLogger(pairingFile: pairingFile,
logPath: logPath,
isConsoleLoggingEnabled: loggingEnabled)
#endif
}
func installProvisioningProfiles(_ profileData: Data) throws {
defer { print("[SideStore] installProvisioningProfiles(profileData) completed") }
#if targetEnvironment(simulator)
print("[SideStore] installProvisioningProfiles(profileData) is no-op on simulator")
#else
print("[SideStore] installProvisioningProfiles(profileData) invoked")
try Minimuxer.installProvisioningProfile(profile: profileData)
#endif
}
func removeProvisioningProfile(_ id: String) throws {
defer { print("[SideStore] removeProvisioningProfile(id) completed") }
#if targetEnvironment(simulator)
print("[SideStore] removeProvisioningProfile(id) is no-op on simulator")
#else
print("[SideStore] removeProvisioningProfile(id) invoked")
try Minimuxer.removeProvisioningProfile(id: id)
#endif
}
func removeApp(_ bundleId: String) throws {
defer { print("[SideStore] removeApp(bundleId) completed") }
#if targetEnvironment(simulator)
print("[SideStore] removeApp(bundleId) is no-op on simulator")
#else
print("[SideStore] removeApp(bundleId) invoked")
try Minimuxer.removeApp(bundleId: bundleId)
#endif
}
func yeetAppAFC(_ bundleId: String, _ rawBytes: Data) throws {
defer { print("[SideStore] yeetAppAFC(bundleId, rawBytes) completed") }
#if targetEnvironment(simulator)
print("[SideStore] yeetAppAFC(bundleId, rawBytes) is no-op on simulator")
#else
print("[SideStore] yeetAppAFC(bundleId, rawBytes) invoked")
try Minimuxer.yeetAppAfc(bundleId: bundleId, ipaBytes: rawBytes)
#endif
}
func installIPA(_ bundleId: String) throws {
defer { print("[SideStore] installIPA(bundleId) completed") }
#if targetEnvironment(simulator)
print("[SideStore] installIPA(bundleId) is no-op on simulator")
#else
print("[SideStore] installIPA(bundleId) invoked")
try Minimuxer.installIpa(bundleId: bundleId)
#endif
}
func fetchUDID() -> String? {
defer { print("[SideStore] fetchUDID() completed") }
#if targetEnvironment(simulator)
print("[SideStore] fetchUDID() is no-op on simulator")
return "XXXXX-XXXX-XXXXX-XXXX"
#else
print("[SideStore] fetchUDID() invoked")
return Minimuxer.fetchUDID()
#endif
}
func debugApp(_ appId: String) throws {
defer { print("[SideStore] debugApp(appId) completed") }
#if targetEnvironment(simulator)
print("[SideStore] debugApp(appId) is no-op on simulator")
#else
print("[SideStore] debugApp(appId) invoked")
try Minimuxer.debugApp(appId: appId)
#endif
}
func attachDebugger(_ pid: UInt32) throws {
defer { print("[SideStore] attachDebugger(pid) completed") }
#if targetEnvironment(simulator)
print("[SideStore] attachDebugger(pid) is no-op on simulator")
#else
print("[SideStore] attachDebugger(pid) invoked")
try Minimuxer.attachDebugger(pid: pid)
#endif
}
func startAutoMounter(_ docsPath: String) {
defer { print("[SideStore] startAutoMounter(docsPath) completed") }
#if targetEnvironment(simulator)
print("[SideStore] startAutoMounter(docsPath) is no-op on simulator")
#else
print("[SideStore] startAutoMounter(docsPath) invoked")
Minimuxer.startAutoMounter(docsPath: docsPath)
#endif
}
func dumpProfiles(_ docsPath: String) throws -> String {
defer { print("[SideStore] dumpProfiles(docsPath) completed") }
#if targetEnvironment(simulator)
print("[SideStore] dumpProfiles(docsPath) is no-op on simulator")
return ""
#else
print("[SideStore] dumpProfiles(docsPath) invoked")
return try Minimuxer.dumpProfiles(docsPath: docsPath)
#endif
}
func setMinimuxerDebug(_ debug: Bool) {
defer { print("[SideStore] setMinimuxerDebug(debug) completed") }
print("[SideStore] setMinimuxerDebug(debug) invoked")
Minimuxer.setDebug(debug)
}
extension MinimuxerError: @retroactive LocalizedError {
public var failureReason: String? {
switch self {
case .NoDevice:
return NSLocalizedString("Cannot fetch the device from the muxer", comment: "")
case .NoConnection:
return NSLocalizedString("Unable to connect to the device, make sure LocalDevVPN is enabled and you're connected to Wi-Fi. This could mean an invalid pairing.", comment: "")
case .PairingFile:
return NSLocalizedString("Invalid pairing file. Your pairing file either didn't have a UDID, or it wasn't a valid plist. Please use iloader to replace it.", comment: "")
case .CreateDebug:
return createService(name: "debug")
case .LookupApps:
return getFromDevice(name: "installed apps")
case .FindApp:
return getFromDevice(name: "path to the app")
case .BundlePath:
return getFromDevice(name: "bundle path")
case .MaxPacket:
return setArgument(name: "max packet")
case .WorkingDirectory:
return setArgument(name: "working directory")
case .Argv:
return setArgument(name: "argv")
case .LaunchSuccess:
return getFromDevice(name: "launch success")
case .Detach:
return NSLocalizedString("Unable to detach from the app's process", comment: "")
case .Attach:
return NSLocalizedString("Unable to attach to the app's process", comment: "")
case .CreateInstproxy:
return createService(name: "instproxy")
case .CreateAfc:
return createService(name: "AFC")
case .RwAfc:
return NSLocalizedString("AFC was unable to manage files on the device.", comment: "")
case .InstallApp(let message):
return NSLocalizedString("Unable to install the app: \(message)", comment: "")
case .UninstallApp:
return NSLocalizedString("Unable to uninstall the app", comment: "")
case .CreateMisagent:
return createService(name: "misagent")
case .ProfileInstall:
return NSLocalizedString("Unable to manage profiles on the device", comment: "")
case .ProfileRemove:
return NSLocalizedString("Unable to manage profiles on the device", comment: "")
case .CreateLockdown:
return NSLocalizedString("Unable to connect to lockdown", comment: "")
case .CreateCoreDevice:
return NSLocalizedString("Unable to connect to core device proxy", comment: "")
case .CreateSoftwareTunnel:
return NSLocalizedString("Unable to create software tunnel", comment: "")
case .CreateRemoteServer:
return NSLocalizedString("Unable to connect to remote server", comment: "")
case .CreateProcessControl:
return NSLocalizedString("Unable to connect to process control", comment: "")
case .GetLockdownValue:
return NSLocalizedString("Unable to get value from lockdown", comment: "")
case .Connect:
return NSLocalizedString("Unable to connect to TCP port", comment: "")
case .Close:
return NSLocalizedString("Unable to close TCP port", comment: "")
case .XpcHandshake:
return NSLocalizedString("Unable to get services from XPC", comment: "")
case .NoService:
return NSLocalizedString("Device did not contain service", comment: "")
case .InvalidProductVersion:
return NSLocalizedString("Service version was in an unexpected format", comment: "")
case .CreateFolder:
return NSLocalizedString("Unable to create DDI folder", comment: "")
case .DownloadImage:
return NSLocalizedString("Unable to download DDI", comment: "")
case .ImageLookup:
return NSLocalizedString("Unable to lookup DDI images", comment: "")
case .ImageRead:
return NSLocalizedString("Unable to read images to memory", comment: "")
case .Mount:
return NSLocalizedString("Mount failed", comment: "")
}
}
fileprivate func createService(name: String) -> String {
String(format: NSLocalizedString("Cannot start a %@ server on the device.", comment: ""), name)
}
fileprivate func getFromDevice(name: String) -> String {
String(format: NSLocalizedString("Cannot fetch %@ from the device.", comment: ""), name)
}
fileprivate func setArgument(name: String) -> String {
String(format: NSLocalizedString("Cannot set %@ on the device.", comment: ""), name)
}
}