如何在macOS上以无界面Objective-C/C++编程添加CalDAV账户？

Hey Dominik, great question—let’s walk through how to programmatically add a CalDAV account on macOS using Objective-C (or Objective-C++ for C++ integration) without any UI-based tools like Accessibility or AppleScript.

You’re right to focus on the Accounts framework—it’s the official system API for managing user accounts, including CalDAV. The key missing piece you might have overlooked is the ACAccountTypeIdentifierCalDAV constant, which identifies the CalDAV account type. We’ll use this with ACAccountStore to create and save the account, along with necessary credentials and server details.

Here’s a complete example that handles permission requests, account creation, and saving:

#import <Accounts/Accounts.h>
#import <EventKit/EventKit.h>

- (void)addCalDAVAccountWithUsername:(NSString *)username
                             password:(NSString *)password
                          serverURL:(NSURL *)serverURL
                          accountDescription:(NSString *)description {
    ACAccountStore *accountStore = [[ACAccountStore alloc] init];
    ACAccountType *calDAVAccountType = [accountStore accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierCalDAV];
    
    // Request user permission to access CalDAV accounts
    [accountStore requestAccessToAccountsWithType:calDAVAccountType options:nil completion:^(BOOL granted, NSError * _Nullable error) {
        if (granted && !error) {
            // Create credentials for the account
            ACAccountCredential *credential = [[ACAccountCredential alloc] initWithUser:username password:password];
            
            // Initialize the CalDAV account object
            ACAccount *calDAVAccount = [[ACAccount alloc] initWithAccountType:calDAVAccountType];
            calDAVAccount.credential = credential;
            calDAVAccount.accountDescription = description;
            
            // Set critical CalDAV-specific property: principal URL (required for server sync)
            [calDAVAccount setValue:serverURL.absoluteString forKey:@"calDAVPrincipalURL"];
            
            // Optional: Configure additional server settings (SSL, port, etc.)
            // [calDAVAccount setValue:@YES forKey:@"calDAVUseSSL"];
            // [calDAVAccount setValue:@443 forKey:@"calDAVPort"];
            
            // Save the account to the system
            [accountStore saveAccount:calDAVAccount withCompletionHandler:^(BOOL success, NSError * _Nullable error) {
                if (success) {
                    NSLog(@"CalDAV account added successfully!");
                } else {
                    NSLog(@"Failed to add CalDAV account: %@", error.localizedDescription);
                }
            }];
        } else {
            NSLog(@"Access denied or error occurred: %@", error.localizedDescription);
        }
    }];
}

Setup Requirements #

• Link the Accounts and EventKit frameworks to your project.
• Add the NSCalendarsUsageDescription key to your Info.plist with a clear explanation of why you need calendar access (required for macOS 10.14+).
• If your app uses App Sandbox, enable the Calendar and Accounts capabilities in your project settings.

Since the Accounts framework is Objective-C-based, you’ll need to use Objective-C++ (.mm files) to bridge to C++. Here’s a simple wrapper function:

#include <string>
#include <objc/runtime.h>
#include <Foundation/Foundation.h>

extern "C" void AddCalDAVAccount(const char* username, const char* password, const char* serverURL, const char* description) {
    NSString *user = [[NSString alloc] initWithUTF8String:username];
    NSString *pass = [[NSString alloc] initWithUTF8String:password];
    NSURL *url = [NSURL URLWithString:[[NSString alloc] initWithUTF8String:serverURL]];
    NSString *desc = [[NSString alloc] initWithUTF8String:description];
    
    @autoreleasepool {
        ACAccountStore *accountStore = [[ACAccountStore alloc] init];
        ACAccountType *calDAVType = [accountStore accountTypeWithAccountTypeIdentifier:ACAccountTypeIdentifierCalDAV];
        
        [accountStore requestAccessToAccountsWithType:calDAVType options:nil completion:^(BOOL granted, NSError *error) {
            if (granted) {
                ACAccountCredential *credential = [[ACAccountCredential alloc] initWithUser:user password:pass];
                ACAccount *account = [[ACAccount alloc] initWithAccountType:calDAVType];
                account.credential = credential;
                account.accountDescription = desc;
                [account setValue:url.absoluteString forKey:@"calDAVPrincipalURL"];
                
                [accountStore saveAccount:account withCompletionHandler:^(BOOL success, NSError *err) {
                    if (success) {
                        printf("CalDAV account added successfully\n");
                    } else {
                        printf("Failed to add account: %s\n", [[err localizedDescription] UTF8String]);
                    }
                }];
            } else {
                printf("Access denied: %s\n", [[error localizedDescription] UTF8String]);
            }
        }];
    }
    
    [user release];
    [pass release];
    [url release];
    [desc release];
}

You can call this function directly from your C++ code by including its declaration.

• User Permission: macOS privacy rules require explicit user consent—you can’t add accounts silently. A system dialog will prompt the user to grant access.
• Principal URL: The calDAVPrincipalURL is mandatory. This should point to your CalDAV server’s principal resource (e.g., https://your-server.com/caldav/user123/).
• Server Compatibility: Some servers may require additional properties (like custom ports or SSL settings). You can set these using key-value pairs on the ACAccount object.
• System Version: The Accounts framework is available on macOS 10.8 and later, so ensure your target deployment version meets this requirement.

内容的提问来源于stack exchange，提问作者dominik