Xcode 26 与 ChatGPT 集成开发指南：从零开始构建智能应用

7次阅读

共计 3134 个字符，预计需要花费 8 分钟才能阅读完成。

ChatGPT 作为强大的自然语言处理模型，为移动应用带来了智能对话、内容生成等能力。对于 iOS 开发者而言，集成 ChatGPT 可以显著提升应用的用户体验，例如实现智能客服、个性化推荐或辅助创作功能。Xcode 26 作为苹果最新的开发工具，提供了更高效的开发环境和调试支持，使得集成第三方 API 更加顺畅。

安装 Xcode 26：确保从 Mac App Store 下载最新版本，并完成基础设置。
创建新项目 ：选择 iOS App 模板，确保语言设置为 Swift，界面选择 SwiftUI 或 UIKit 根据个人偏好。
安装依赖库 ：通过 Swift Package Manager 或 CocoaPods 添加 Alamofire 或 URLSession 网络请求库。

// 使用 Swift Package Manager 添加 Alamofire
dependencies: [.package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.6.4")
]

获取 OpenAI API 密钥 ：在 OpenAI 官网注册并获取 API 密钥，妥善保存以备后续使用。

设置 API 请求 ：创建一个网络请求管理器类，处理与 ChatGPT 的通信。

import Alamofire

class ChatGPTManager {
    private let apiKey = "YOUR_API_KEY"
    private let endpoint = "https://api.openai.com/v1/chat/completions"

    func sendMessage(message: String, completion: @escaping (Result<String, Error>) -> Void) {
        let headers: HTTPHeaders = ["Authorization": "Bearer \(apiKey)",
            "Content-Type": "application/json"
        ]

        let parameters: [String: Any] = [
            "model": "gpt-3.5-turbo",
            "messages": [["role": "user", "content": message]
            ]
        ]

        AF.request(endpoint, method: .post, parameters: parameters, encoding: JSONEncoding.default, headers: headers)
            .validate()
            .responseDecodable(of: ChatResponse.self) { response in
                switch response.result {case .success(let chatResponse):
                    completion(.success(chatResponse.choices[0].message.content))
                case .failure(let error):
                    completion(.failure(error))
                }
            }
    }
}

处理响应 ：定义响应数据结构并解析返回的 JSON。

struct ChatResponse: Codable {
    struct Choice: Codable {
        struct Message: Codable {let content: String}
        let message: Message
    }
    let choices: [Choice]
}

以下是一个完整的 SwiftUI 示例，展示如何调用 ChatGPT API 并在界面中显示结果。

import SwiftUI

struct ContentView: View {
    @State private var userInput = ""@State private var responseText =""
    @State private var isLoading = false

    let chatGPTManager = ChatGPTManager()

    var body: some View {
        VStack {TextField("Enter your message", text: $userInput)
                .textFieldStyle(RoundedBorderTextFieldStyle())
                .padding()

            Button(action: sendMessage) {
                if isLoading {ProgressView()
                } else {Text("Send")
                }
            }
            .padding()

            Text(responseText)
                .padding()}
    }

    func sendMessage() {
        isLoading = true
        chatGPTManager.sendMessage(message: userInput) { result in
            DispatchQueue.main.async {
                isLoading = false
                switch result {case .success(let response):
                    responseText = response
                case .failure(let error):
                    responseText = "Error: \(error.localizedDescription)"
                }
            }
        }
    }
}

缓存响应 ：对频繁请求的相同内容进行本地缓存，减少 API 调用次数。

let cache = NSCache<NSString, NSString>()

func sendMessage(message: String, completion: @escaping (Result<String, Error>) -> Void) {if let cachedResponse = cache.object(forKey: message as NSString) {completion(.success(cachedResponse as String))
        return
    }

    // 原有 API 请求代码
    AF.request(...) { response in
        if case .success(let responseText) = response {cache.setObject(responseText as NSString, forKey: message as NSString)
        }
        completion(response)
    }
}

节流请求 ：避免用户快速连续发送请求，可以使用 debounce 技术延迟处理输入。
压缩请求数据 ：减少传输数据量，提升请求速度。

API 密钥泄露 ：永远不要将 API 密钥硬编码在客户端代码中，应该通过后端服务中转请求。
网络错误处理 ：确保正确处理网络连接问题，提供友好的错误提示。
响应超时 ：设置合理的超时时间，避免用户长时间等待。

AF.request(endpoint, method: .post, parameters: parameters, encoding: JSONEncoding.default, headers: headers)
    .validate()
    .responseDecodable(of: ChatResponse.self) { response in
        // 处理响应
    }
    .uploadProgress { progress in
        // 可以在这里显示上传进度
    }
    .downloadProgress { progress in
        // 可以在这里显示下载进度
    }