---
schema_version: "1"
id: c278312e8767f5f22c509b551304bd274b29ec164497353bfba8077381ab79ce
title: iOS Architecture Integration
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/genai/agentforce-mobile-sdk/references/ios/development-ios.md
canonical_url: https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/development-ios.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: d913cf51161d874d4880e5015eb0bfd88ca8ebd82b2360ae0fb392f0af5a448e
products:
  - Agentforce Mobile SDK
  - Agentforce and Einstein Generative AI
---
# iOS Architecture Integration

Technical reference for iOS platform integration patterns and requirements.

## System Requirements

| Requirement  | Version             |
| ------------ | ------------------- |
| iOS          | 17.0+               |
| Xcode        | 16.0+               |
| Swift        | 5.0+                |
| Dependencies | SalesforceMobileSDK |

## Core Integration Points

Essential API signatures and patterns for iOS integration.

### Client Initialization

```swift
AgentforceClient(
    credentialProvider: AgentforceAuthCredentialProviding,
    agentforceConfiguration: AgentforceConfiguration
)
```

### Conversation Management

```swift
client.startAgentforceConversation(
    forAgentId: String,
    sessionId: String?
) -> AgentConversation
```

### UI Component Creation

```swift
client.createAgentforceChatView(
    conversation: AgentConversation,
    delegate: AgentforceUIDelegate?,
    onContainerClose: () -> Void
) -> AgentforceChatView
```

## Component Reference

Complete reference of iOS components and protocols.

### UI Components

| Component                                                   | Type         | Description                             |
| ----------------------------------------------------------- | ------------ | --------------------------------------- |
| [AgentforceChatView](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-chat-view-ios.md)           | SwiftUI View | Full conversational interface           |
| [AgentforceCard](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-card-ios.md)                    | SwiftUI View | Compact conversation summary            |
| [AgentforceLauncher](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-launcher-ios.md)            | SwiftUI View | Floating launcher interface             |
| [ConversationUIContainer](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/conversation-ui-container-ios.md) | SwiftUI View | Container for embedding conversation UI |

### Core Protocols

| Protocol                                                    | Purpose                                                                                     |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [AgentConversation](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agent-conversation-ios.md)              | Conversation interface and state management                                                 |
| [AgentforceDataProviding](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/agentforce-data-providing-ios.md) | Data access abstraction                                                                     |
| [Typography & Fonts](https://developer.salesforce.com/docs/ai/agentforce-mobile-sdk/references/agentforce-mobile-sdk/typography-and-fonts-ios.md)           | Font customization; one of several theming areas alongside colors, icons, and display names |

## Related Documentation

- [UI Components Implementation Guide](/docs/ai/agentforce-mobile-sdk/guide/agentforce-mobile-sdk-ui-components.html) - Usage patterns and examples
- [iOS Integration Guidelines](/docs/ai/agentforce-mobile-sdk/guide/agentforce-mobile-sdk-ios.html) - Complete setup instructions
- [Architecture Guide](/docs/ai/agentforce-mobile-sdk/guide/agentforce-mobile-sdk-architecture.html) - Design patterns and concepts