### Setup Delta Chat iOS Workspace

Source: https://github.com/deltachat/deltachat-ios/blob/main/README.md

Clones the Delta Chat iOS repository, initializes and updates its git submodules, installs the required Rust toolchain version specified in 'rust-toolchain', and installs project dependencies using CocoaPods. Finally, it opens the Xcode workspace.

```bash
git clone git@github.com:deltachat/deltachat-ios.git
cd deltachat-ios
git submodule update --init --recursive
# Make sure the correct rust version is installed
rustup toolchain install `cat rust-toolchain`
pod install
open deltachat-ios.xcworkspace
```

--------------------------------

### Install rustup

Source: https://github.com/deltachat/deltachat-ios/blob/main/README.md

Installs rustup, the toolchain manager for Rust, which is a prerequisite for building the Delta Chat iOS client. This command downloads and executes the official rustup installation script.

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

--------------------------------

### Install CocoaPods

Source: https://github.com/deltachat/deltachat-ios/blob/main/README.md

Installs CocoaPods, a dependency manager for Swift and Objective-C Cocoa projects. This command uses Homebrew to install CocoaPods, which is used to manage iOS project dependencies.

```bash
brew install cocoapods
```

--------------------------------

### Install Xcode Command Line Tools

Source: https://github.com/deltachat/deltachat-ios/blob/main/README.md

Installs the Xcode command line tools, which are necessary for many development tasks, including compiling code and using developer utilities. This command prompts the user to install the tools if they are not already present.

```bash
xcode-select --install
```

--------------------------------

### Force Install macOS SDK Headers

Source: https://github.com/deltachat/deltachat-ios/blob/main/README.md

Installs macOS SDK headers for a specific SDK version, often required when Xcode complains about missing header files on certain macOS versions. This command uses the installer utility to apply the package.

```bash
sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /
```

--------------------------------

### Install cargo-lipo

Source: https://github.com/deltachat/deltachat-ios/blob/main/README.md

Installs cargo-lipo, a Cargo extension that helps in building fat universal binaries for iOS and other platforms. This is necessary for integrating Rust code into the iOS project.

```bash
cargo install cargo-lipo
```

--------------------------------

### Initialize App with Shared Database and Keychain Secrets in Swift

Source: https://context7.com/deltachat/deltachat-ios/llms.txt

Demonstrates the usage of `DatabaseHelper` and `KeychainManager` within the `AppDelegate`'s `application(_:didFinishLaunchingWithOptions:)` method in Swift. This code snippet shows how to open the shared database and then iterate through all available accounts, retrieving their secrets from the Keychain to open each account context. It includes basic error handling for Keychain operations and database opening.

```swift
// Usage in AppDelegate
func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    // Open shared database
    dcAccounts.openDatabase(writeable: true)

    // Open all accounts with keychain secrets
    let accountIds = dcAccounts.getAll()
    for accountId in accountIds {
        let dcContext = dcAccounts.get(id: accountId)

        do {
            let secret = try KeychainManager.getAccountSecret(accountID: accountId)
            if !dcContext.open(passphrase: secret) {
                print("Failed to open account \(accountId)")
            }
        } catch {
            print("Keychain error for account \(accountId): \(error)")
        }
    }

    return true
}
```

--------------------------------

### Sending and Managing Messages in Swift

Source: https://context7.com/deltachat/deltachat-ios/llms.txt

Illustrates various message operations using the Delta Chat SDK in Swift, including creating and sending text/image/file messages, replying, forwarding, editing, deleting, retrieving message lists, marking as seen, managing drafts, and downloading full messages. It also shows how to get detailed message information.

```swift
import Foundation

// Assuming dcContext, chatId, anotherChatId, spammerId, msgId, and messageIds are defined instances.

// Create and send text message
let msg = dcContext.newMessage(viewType: DC_MSG_TEXT)
msg.text = "Hello from Delta Chat!"
dcContext.sendMessage(chatId: chatId, message: msg)

// Send message with image attachment
let imageMsg = dcContext.newMessage(viewType: DC_MSG_IMAGE)
imageMsg.setFile(filepath: "/path/to/image.jpg", mimeType: "image/jpeg")
imageMsg.text = "Check out this photo"
dcContext.sendMessage(chatId: chatId, message: imageMsg)

// Send file attachment
let fileMsg = dcContext.newMessage(viewType: DC_MSG_FILE)
fileMsg.setFile(filepath: "/path/to/document.pdf", mimeType: "application/pdf")
dcContext.sendMessage(chatId: chatId, message: fileMsg)

// Reply to message with quote
let quotedMsg = dcContext.newMessage(viewType: DC_MSG_TEXT)
quotedMsg.text = "I agree!"
quotedMsg.quoteMessage(quotedMessageId: 42)
dcContext.sendMessage(chatId: chatId, message: quotedMsg)

// Forward message to another chat
dcContext.forwardMessages(messageIds: [123, 124], toChatId: anotherChatId)

// Edit existing message
dcContext.sendEditRequest(msgId: 123, newText: "Corrected message text")

// Delete messages (sends delete request to all recipients)
dcContext.sendDeleteRequest(msgIds: [123, 124, 125])

// Get messages in chat
let messageFlags: Int32 = 0  // DC_GCL_FOR_FORWARDING, DC_GCL_ADD_DAYMARKER, etc.
let messageIds = dcContext.getChatMsgs(chatId: chatId, flags: messageFlags)

for msgId in messageIds {
    let msg = dcContext.getMessage(id: msgId)
    let contact = dcContext.getContact(id: msg.fromContactId)
    print("[\(msg.formattedSentDate())] \(contact.displayName): \(msg.text ?? "")")
}

// Mark messages as seen
dcContext.markSeenMessages(messageIds: [123, 124])

// Manage drafts (auto-saved in core)
let draftMsg = dcContext.newMessage(viewType: DC_MSG_TEXT)
draftMsg.text = "Work in progress..."
dcContext.setDraft(chatId: chatId, message: draftMsg)

// Retrieve draft
if let draft = dcContext.getDraft(chatId: chatId) {
    print("Draft: \(draft.text ?? "")")
}

// Clear draft
dcContext.setDraft(chatId: chatId, message: nil)

// Download full message (if only partial downloaded)
dcContext.downloadFullMessage(id: msgId)

// Get message details
let msg = dcContext.getMessage(id: msgId)
print("From: \(msg.fromContactId)")
print("Chat: \(msg.chatId)")
print("Type: \(msg.viewType)")  // DC_MSG_TEXT, DC_MSG_IMAGE, etc.
print("Text: \(msg.text ?? "")")
print("File: \(msg.filename ?? "none")")
print("Size: \(msg.getPrettyFileSize())")
print("Forwarded: \(msg.isForwarded)")
print("Edited: \(msg.isEdited)")

```