This is a big release! Continued thanks to @amomchilov for his contributions and code reviews.
New functionality
- Adds built-in support for macOS Ventura's new
SMAppService
's daemons & agents.- For simple configurations, just call
XPCServer.forMachService()
and an auto-configured server will be returned.
- For simple configurations, just call
- Experimental support for shared memory has been added. Shared memory is truly shared between processes, no encoding or decoding occurs like with typical XPC communication.
- A friendly to use, although quite basic, data structure
SharedTrivial
demonstrates this functionality. - The building block pieces available through
SharedSemaphore
,SharedMemory
, andSharedRawMemory
should enable you to build your own custom multi-process data structures. - This support is experimental and while it remains experimental breaking changes to it will not be considered for SerVer purposes.
- A friendly to use, although quite basic, data structure
XPCClient
now provides the unforgeable identity of the server it is connected to via itsserverIdentity
async property (or the equivalent callback function).XPCClient
now automatically verifies the identity of the server in common cases and this can be customized withXPCClient.ServerRequirement
.XPCServer
instances now always have anendpoint
property (previously only those also conforming toXPCNonBlockingServer
had this property).- Send
IOSurface
instances over XPC connections using theIOSurfaceForXPC
property wrapper. Data
instances and arrays of trivial types can optionally be more efficiently sent across XPC connections by using theDataOptimizedForXPC
andArrayOptimizedForXPC
property wrappers.
Breaking changes
XPCServer
retrieval has been simplified. There are now just three main entry points:XPCServer.forThisXPCService()
XPCServer.forMachService()
XPCServer.makeAnonymous()
XPCServer
retrieval is now more customizable.- To customize a Mach service use
XPCServer.MachServiceCriteria
then callXPCServer.forMachService(withCriteria:)
- To customize an anonymous server use
XPCServer.makeAnonymous(withClientRequirement:)
- To customize a Mach service use
XPCServer
's client requirements no longer require usingSecRequirement
directly (although that's still supported).- Requirements are now created using
XPCServer.ClientRequirement
and declarative in nature:XPCServer.makeAnonymous(withClientRequirement: try .sameTeamIdentifier || try .teamIdentifier("Q55ZG849VX"))
- Requirements are now created using
XPCClient
's factory methods have been tweaked to now optionally take aXPCClient.ServerRequirement
instance.XPCFileDescriptorContainer
has been replaced by theFileHandleForXPC
andFileDescriptorForXPC
property wrappers.XPCRequestContext
has been renamed toXPCServer.ClientIdentity
.- Several
XPCError
cases have been removed and a few have been added. - The underlying interprocess communication protocol between the client and server has changed (to support the client's ability to verify the server's identity). This means if you update SecureXPC, you need to do so for both your client and server implementations at the same time.