We are building iPadOS App that uses bundled DriveKit driver to communicate with USB device. This bundled driver should be enabled first by user from App's settings or Privacy & Security page. We read in Apple Docs that openSettingsURLString is recommended way to navigate user to App's settings.
We added alert that is shown on App launch and has option to open settings.
Our solution perfectly works on local DEBUG build. So user is navigated to App's settings when he click "Open Settings".
However it doesn't work for TestFlight/App Store builds. "Open Settings" just opens system Settings app on some random page.
Code:
let settingsURL = URL(string: UIApplication.openSettingsURLString)!
UIApplication.shared.open(settingsURL)
Environment:
Xcode Version 14.1(14B47b)
iPadOS 16.1.1(20B101)
Note: Our Settings.bundle contains Root.plist with no custom settings:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict/>
</plist>
We read speculations that some permission request should be triggered before navigation. Unfortunately, there is no API that checks or requests permission for DriverKit in the moment.
Selecting any option will automatically load the page
Post
Replies
Boosts
Views
Activity
We are experimenting with DriverKit on macOS while DriverKit is still in beta on iPadOS. We want to build a Driver for iPad that will allow to communicate our iPad App with USB device.
What we did:
Configured and implemented a driver that uses USBDriverKit::IOUSBHostInterface as provider. This driver is automatically matched/started by macOS when we plug our device into USB port. Next we utilised USBDriverKit::IOUSBHostPipe to send/receive data from our device. We print data from device in logs for now.
Studied Communicating Between a DriverKit Extension and a Client App
Configured and implemented a driver that based on IOUserClient and allows to open communication channel by macOs App using IOServiceOpen API. Driver has callback to pass data to macOS Client App.
Currently we want to combine 2 drivers and pass data received from USB device to our client App using callback. Unfortunately, we stuck since now we have 2 instances of driver:
First instance is automatically run by macOS when device is plugged
Second instance is created when we are connecting from Client App and virtual kern_return_t NewUserClient(uint32_t type, IOUserClient** userClient) method is called.
So we can't use second instance to do USB device communication since it has wrong provider(IOUserClient) in kern_return_t Start(IOService * provider) but we need IOUSBHostInterface to start:
ivars->interface = OSDynamicCast(IOUSBHostInterface, provider);
if(ivars->interface == NULL) {
ret = kIOReturnNoDevice;
goto Exit;
}
Are we doing it wrong? Maybe instead of automatic matching for IOUSBHostInterface we should do it manually from UserClient driver or use another approach?
As we learned we have to create a new service instance in NewUserClient method and can't return driver that was run by OS:
kern_return_t IMPL(MyDriver, NewUserClient)
{
kern_return_t ret = kIOReturnSuccess;
IOService* client = nullptr;
ret = Create(this, "UserClientProperties", &client);
if (ret != kIOReturnSuccess)
{
goto Exit;
}
*userClient = OSDynamicCast(IOUserClient, client);
if (*userClient == NULL)
{
client->release();
ret = kIOReturnError;
goto Exit;
}
Exit:
return ret;
}
BTW, maybe there is much easier way to forward data from USB device to iPadOS App?
We are experiencing missing coverage for private variables in SwiftUI views after update from Xcode 14.3 to Xcode 14.2.
Steps to reproduce:
Create new SwiftUI project in Xcode
Enable code coverage
Modify ContentView to
struct ContentView: View {
private let title = "Hello, world!"
let text: String
var body: some View {
VStack {
Text(title)
Text(text)
}
.padding()
}
}
Run UITest - CoverageTestTests::testExample
Check coverage in Xcode for ContentView
Actual result: Line private let title = "Hello, world!" is not covered.
Expected result: Line should be covered
Workaround: Generate initialiser for ContentView
init(text: String) {
self.text = text
}
Coverage is correct when initialiser is added explicitly
Test project: https://github.com/yuri-qualtie/CoverageTest
In following code example:
struct ContentView: View {
@State var text: String = "sample text"
var body: some View {
VStack {
TextField("", text: $text)
Button(action: { print("action performed!") }) {
Text("Click me")
}
.keyboardShortcut(.defaultAction)
}
.padding(40)
}
}
.keyboardShortcut(.defaultAction) that is attached to Button perfectly works on macOs Big Sur(11.6) and I see "action performed!" in Xcode console when tap Enter key on keyboard.
Unfortunately, same example doesn't work on macOs Monterey(12.0.1) and Xcode 13.1. So nothing happens(I don't see any logs) when I tap Enter key on keyboard. Also I noticed that it happens only when focus is set in TextField.
I checked that onSubmit can solve this issue.
Unfortunately, I can't use since it's available in macOs 12 or newer but my App has deployment target is macOs 11.
So any workarounds are welcomed.
We are developing driver for our USB device. Our approach is to run and test driver on macOS first and then verify on iPadOS 16. In the driver we add custom property -"kUSBSerialNumberString" into default properties:
OSDictionary * Driver::devicePropertiesWithSerialNumber() {
kern_return_t ret;
OSDictionary *properties = NULL;
OSDictionary *dictionary = NULL;
OSObjectPtr value;
const IOUSBDeviceDescriptor *deviceDescriptor;
deviceDescriptor = ivars->device->CopyDeviceDescriptor();
ret = CopyProperties(&properties);
value = copyStringAtIndex(deviceDescriptor->iSerialNumber, kIOUSBLanguageIDEnglishUS);
Log("Serial number: %{public}s", ((OSString *)value)->getCStringNoCopy());
dictionary = OSDictionary::withDictionary(properties, 0);
OSSafeReleaseNULL(properties);
if (value) {
OSDictionarySetValue(dictionary, "kUSBSerialNumberString", value);
OSSafeReleaseNULL(value);
}
return dictionary;
}
next in kern_return_t IMPL(Driver, Start) we call SetProperties:
ret = SetProperties(devicePropertiesWithSerialNumber());
if(ret != kIOReturnSuccess) {
Log("Start() - Failed to set properties: 0x%08x.", ret);
goto Exit;
}
We can read our property on macOS using:
func getDeviceProperty(device: io_object_t, key: String) -> AnyObject? {
IORegistryEntryCreateCFProperty(
device, key as CFString, kCFAllocatorDefault, .zero
)?.takeRetainedValue()
}
if let serialNumber = getDeviceProperty(device: driver, key: "kUSBSerialNumberString") {
print("serialNumber: \(serialNumber)")
}
However getDevicePropertyon iPadOS returns nil. We are wondering is any limitation for IORegistry entries(properties) on iPadOS16? Is any way to add custom property to IORegistry?
BTW, we added debug method to print all the available properties for IORegistry:
private func debugRegistry(device: io_object_t) {
var dictionary: Unmanaged<CFMutableDictionary>?
IORegistryEntryCreateCFProperties(device, &dictionary, kCFAllocatorDefault, .zero)
if let dictionary = dictionary {
let values = dictionary.takeUnretainedValue()
print(values)
}
}
It returns just 1 property for iPadOS:
{
IOClass = IOUserService;
}
and much more for macOS including our custom one:
{
CFBundleIdentifier = "****";
CFBundleIdentifierKernel = "com.apple.kpi.iokit";
IOClass = IOUserService;
IOMatchCategory = "***";
IOMatchedPersonality = {
CFBundleIdentifier = "****";
CFBundleIdentifierKernel = "com.apple.kpi.iokit";
IOClass = IOUserService;
IOMatchCategory = "****";
IOPersonalityPublisher = "****";
IOProviderClass = IOUSBHostInterface;
IOResourceMatch = IOKit;
IOUserClass = Driver;
IOUserServerCDHash = 9cfd03b5c1b90da709ffb1455a053c5d7cdf47ac;
IOUserServerName = "*****";
UserClientProperties = {
IOClass = IOUserUserClient;
IOUserClass = DriverUserClient;
};
bConfigurationValue = 1;
bInterfaceNumber = 1;
bcdDevice = 512;
idProduct = XXXXX;
idVendor = XXXXX;
};
IOPersonalityPublisher = "*****";
IOPowerManagement = {
CapabilityFlags = 2;
CurrentPowerState = 2;
MaxPowerState = 2;
};
IOProbeScore = 100000;
IOProviderClass = IOUSBHostInterface;
IOResourceMatch = IOKit;
IOUserClass = Driver;
IOUserServerCDHash = 9cfd03b5c1b90da709ffb1455a053c5d7cdf47ac;
IOUserServerName = "*****";
UserClientProperties = {
IOClass = IOUserUserClient;
IOUserClass = DriverUserClient;
};
bConfigurationValue = 1;
bInterfaceNumber = 1;
bcdDevice = 512;
idProduct = XXXXX;
idVendor = XXXXXX;
kUSBSerialNumberString = XXXXXXXXXXX;
}
Based on official docs click is available for iPadOS apps.
We utilized click action to create universal UITests for macOS and iPadOS targets.
It works fine on iPadOS 16.x but, unfortunately, stops to work in iOS 17 simulators for iPad.
Environment:
MacOS - 13.5.2 (22G91).
Xcode - Version 15.0 (15A240d).
Simulator - Version 15.0 (1015.2).
SimulatorKit 935.1.
CoreSimulator 920.6.
Steps to reproduce:
Create new multiplatform app
Add simple button. For example:
struct ContentView: View {
@State var title = "Click Me"
var body: some View {
VStack {
Button(title) {
title = "Clicked"
}
.background(Color.blue)
.foregroundColor(.white)
}
.padding()
}
}
Add UITest that clicks on button. For example:
func testClick() throws {
let app = XCUIApplication()
app.launch()
app.buttons["Click Me"].click()
XCTAssertTrue(app.buttons["Clicked"].exists)
}
Expected result: test is passed
Actual result: test is failed since buttons["Click Me"].click() doesn't click in button.
Workaround:
Replacement .click() to .tap() fixes the issue but it makes impossible to create universal tests with single action for both platforms
struct SheetView: View {
@Binding var showSheet: Bool
var body: some View {
LazyVStack {
Button("Dismiss") {
showSheet.toggle()
}
}
}
}
struct ContentView: View {
@State private var showSheet = false
var body: some View {
Button("Show") {
showSheet.toggle()
}
.sheet(isPresented: $showSheet) {
SheetView(showSheet: $showSheet)
}
}
}
Xcode displays === AttributeGraph: cycle detected through attribute 119104 === message in console when SheetView is presented on screen.
Environment: macOS 14.4.1
Xcode: Version 15.2
We develop and test App for macOS. We start to see system alert - "UlTests-Runner" would like to access data from other apps on each UITest run.
Our test suite does cleanup of files generated by App so we need access outside of UITests-Runner sandbox.
We enabled Full Disk Access for UITests-Runner at Settings -> Privacy & Security -> Full Disk Access but unfortunately still see this alert.
Is there any way to permanently remove/hide this alert or remove sandbox for 'UITests-Runner' since we want to run tests on CI and having this alert is not an option?
Note: everything works fine on previous versions of macOS.
Environment:
macOS - 15.1 (24B83)
Xcode - Version 16.1 (16B40)
Apple Docs mentions that driver should be approved(enabled) in Settings app.
I wonder is there any API available to check that driver is not enabled?
To my mind, App with driver should have a following flow:
Run App
Check that driver is(not) enabled
Display message(alert) and ask to enable driver in Settings. Optionally: provide shortcut to exact Settings page
Unfortunately, it's not obvious how to check that driver is enabled.