Add the CoreAudio framework

crates/header-translator/src/rust_type.rs

@@ -628,7 +628,7 @@ impl Ty {
                 let declaration = ty.get_declaration().expect("record declaration");
                 let id = ItemIdentifier::new_optional(&declaration, context);
 
-                // Override for self-referential types
+                // Override for self-referential / recursive types
                 let fields = if matches!(
                     id.name.as_deref(),
                     Some(

crates/objc2/src/topics/about_generated/CHANGELOG.md

@@ -25,6 +25,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
   - `AVFoundation` / `objc2-av-foundation`.
   - `AVRouting` / `objc2-av-routing`.
   - `CoreAudioTypes` / `objc2-core-audio-types`.
+  - `CoreAudio` / `objc2-core-audio`.
   - `ColorSync` / `objc2-color-sync`.
   - `CoreGraphics` / `objc2-core-graphics`.
   - `CoreFoundation` / `objc2-core-foundation`.

crates/objc2/src/topics/about_generated/list_data.md

@@ -23,6 +23,7 @@
 | `ColorSync` | [![`objc2-color-sync`](https://badgen.net/crates/v/objc2-color-sync)](https://crates.io/crates/objc2-color-sync) | [![docs.rs](https://docs.rs/objc2-color-sync/badge.svg)](https://docs.rs/objc2-color-sync/) |
 | `Contacts` | [![`objc2-contacts`](https://badgen.net/crates/v/objc2-contacts)](https://crates.io/crates/objc2-contacts) | [![docs.rs](https://docs.rs/objc2-contacts/badge.svg)](https://docs.rs/objc2-contacts/) |
 | `ContactsUI` | [![`objc2-contacts-ui`](https://badgen.net/crates/v/objc2-contacts-ui)](https://crates.io/crates/objc2-contacts-ui) | [![docs.rs](https://docs.rs/objc2-contacts-ui/badge.svg)](https://docs.rs/objc2-contacts-ui/) |
+| `CoreAudio` | [![`objc2-core-audio`](https://badgen.net/crates/v/objc2-core-audio)](https://crates.io/crates/objc2-core-audio) | [![docs.rs](https://docs.rs/objc2-core-audio/badge.svg)](https://docs.rs/objc2-core-audio/) |
 | `CoreAudioTypes` | [![`objc2-core-audio-types`](https://badgen.net/crates/v/objc2-core-audio-types)](https://crates.io/crates/objc2-core-audio-types) | [![docs.rs](https://docs.rs/objc2-core-audio-types/badge.svg)](https://docs.rs/objc2-core-audio-types/) |
 | `CoreBluetooth` | [![`objc2-core-bluetooth`](https://badgen.net/crates/v/objc2-core-bluetooth)](https://crates.io/crates/objc2-core-bluetooth) | [![docs.rs](https://docs.rs/objc2-core-bluetooth/badge.svg)](https://docs.rs/objc2-core-bluetooth/) |
 | `CoreData` | [![`objc2-core-data`](https://badgen.net/crates/v/objc2-core-data)](https://crates.io/crates/objc2-core-data) | [![docs.rs](https://docs.rs/objc2-core-data/badge.svg)](https://docs.rs/objc2-core-data/) |

crates/test-frameworks/Cargo.toml

@@ -58,6 +58,8 @@ test-frameworks = [
     "objc2-contacts/all",
     "dep:objc2-contacts-ui",
     "objc2-contacts-ui/all",
+    "dep:objc2-core-audio",
+    "objc2-core-audio/all",
     "dep:objc2-core-audio-types",
     "objc2-core-audio-types/all",
     "dep:objc2-core-bluetooth",
@@ -227,6 +229,7 @@ objc2-accessibility = { path = "../../framework-crates/objc2-accessibility", opt
 objc2-authentication-services = { path = "../../framework-crates/objc2-authentication-services", optional = true }
 objc2-cloud-kit = { path = "../../framework-crates/objc2-cloud-kit", optional = true }
 objc2-color-sync = { path = "../../framework-crates/objc2-color-sync", optional = true }
+objc2-core-audio = { path = "../../framework-crates/objc2-core-audio", optional = true }
 objc2-core-audio-types = { path = "../../framework-crates/objc2-core-audio-types", optional = true }
 objc2-core-bluetooth = { path = "../../framework-crates/objc2-core-bluetooth", optional = true }
 objc2-core-data = { path = "../../framework-crates/objc2-core-data", optional = true }

framework-crates/objc2-audio-toolbox/translation-config.toml

@@ -95,20 +95,6 @@ class.AUAudioUnitBus.methods."setFormat:error:".skipped = true
 class.AUAudioUnit.methods."shouldChangeToFormat:forBus:".skipped = true
 class.AUAudioUnitBus.methods."initWithFormat:error:".skipped = true
 
-# Needs CoreAudio
-fn.AudioHardwareServiceHasProperty.skipped = true
-fn.AudioHardwareServiceIsPropertySettable.skipped = true
-fn.AudioHardwareServiceGetPropertyDataSize.skipped = true
-fn.AudioHardwareServiceGetPropertyData.skipped = true
-fn.AudioHardwareServiceSetPropertyData.skipped = true
-fn.AudioHardwareServiceAddPropertyListener.skipped = true
-fn.AudioHardwareServiceRemovePropertyListener.skipped = true
-enum.anonymous.constants.kAudioHardwareServiceProperty_ServiceRestarted.skipped = true
-enum.anonymous.constants.kAudioHardwareServiceDeviceProperty_VirtualMainVolume.skipped = true
-enum.anonymous.constants.kAudioHardwareServiceDeviceProperty_VirtualMasterVolume.skipped = true
-enum.anonymous.constants.kAudioHardwareServiceDeviceProperty_VirtualMainBalance.skipped = true
-enum.anonymous.constants.kAudioHardwareServiceDeviceProperty_VirtualMasterBalance.skipped = true
-
 # Needs ComponentDescription from CoreServices
 fn.AUGraphNewNode.skipped = true
 fn.AUGraphGetNodeInfo.skipped = true

framework-crates/objc2-core-audio/src/lib.rs

@@ -0,0 +1,26 @@
+//! # Bindings to the `CoreAudio` framework
+//!
+//! See [Apple's docs][apple-doc] and [the general docs on framework crates][framework-crates] for more information.
+//!
+//! [apple-doc]: https://developer.apple.com/documentation/coreaudio/
+//! [framework-crates]: https://docs.rs/objc2/latest/objc2/topics/about_generated/index.html
+#![no_std]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
+// Update in Cargo.toml as well.
+#![doc(html_root_url = "https://docs.rs/objc2-core-audio/0.2.2")]
+
+#[cfg(feature = "alloc")]
+extern crate alloc;
+
+#[cfg(feature = "std")]
+extern crate std;
+
+mod generated;
+#[allow(unused_imports, unreachable_pub)]
+pub use self::generated::*;
+
+// MacTypes.h
+#[allow(dead_code)]
+pub(crate) type Boolean = u8;
+#[allow(dead_code)]
+pub(crate) type OSStatus = i32;

framework-crates/objc2-core-audio/translation-config.toml

@@ -0,0 +1,28 @@
+framework = "CoreAudio"
+crate = "objc2-core-audio"
+required-crates = ["objc2-core-foundation"]
+custom-lib-rs = true
+macos = "10.0"
+maccatalyst = "13.1"
+ios = "2.0"
+tvos = "9.0"
+watchos = "3.0"
+visionos = "1.0"
+
+# Self-referential / recursive structs
+struct.AudioServerPlugInHostInterface.skipped = true
+typedef.AudioServerPlugInHostInterface.skipped = true
+typedef.AudioServerPlugInHostRef.skipped = true
+struct.AudioServerPlugInDriverInterface.skipped = true
+typedef.AudioServerPlugInDriverInterface.skipped = true
+typedef.AudioServerPlugInDriverRef.skipped = true
+
+# Needs dispatch_queue_t from libdispatch
+fn.AudioObjectAddPropertyListenerBlock.skipped = true
+fn.AudioObjectRemovePropertyListenerBlock.skipped = true
+fn.AudioDeviceCreateIOProcIDWithBlock.skipped = true
+
+# This is currently emitted incorrectly, the union field is
+# not included, which is an ABI mismatch.
+struct.AudioServerPlugInIOCycleInfo.skipped = true
+typedef.AudioServerPlugInIOCycleInfo.skipped = true

framework-crates/objc2-core-media/translation-config.toml

@@ -15,11 +15,6 @@ fn.CMTimebaseRemoveTimerDispatchSource.skipped = true
 fn.CMTimebaseSetTimerDispatchSourceNextFireTime.skipped = true
 fn.CMTimebaseSetTimerDispatchSourceToFireImmediately.skipped = true
 
-# Needs AudioDeviceID from CoreAudio
-fn.CMAudioDeviceClockCreateFromAudioDeviceID.skipped = true
-fn.CMAudioDeviceClockSetAudioDeviceID.skipped = true
-fn.CMAudioDeviceClockGetAudioDevice.skipped = true
-
 # Unknown how to handle the calling convention for arrays
 fn.CMTextFormatDescriptionGetDefaultStyle.skipped = true