📚 课程目录第1章创建第一个iOS应用并配置开发环境

1. 创建第一个iOS应用并配置开发环境

任务说明

本案例目标是在macOS环境下，从零创建一个可运行的iOS单视图应用，并完成开发环境配置。最终交付物为一个能在Xcode模拟器中启动、显示自定义文本的iOS工程，同时验证代码签名与模拟器部署链路正常。

开发环境要求

macOS 13或更高版本
Xcode 15或更高版本（含iOS 17 SDK）
Apple ID（用于签名设置，模拟器运行不需要付费开发者账号）

创建工程步骤

打开Xcode，选择 File > New > Project。
选择 iOS > App 模板，点击Next。
Product Name填写 HelloWorld，Team选择自己的Apple ID（或留空），Organization Identifier填写 com.example，Interface选择 SwiftUI，Language选择 Swift，取消勾选Core Data等附加选项，点击Next并选择保存位置。

核心代码实现

工程创建后，Xcode会自动生成 HelloWorldApp.swift 和 ContentView.swift 两个核心文件。我们只需修改 ContentView.swift 来实现自定义界面：

import SwiftUI

struct ContentView: View {
    var body: some View {
        VStack(spacing: 20) {
            Image(systemName: "apple.logo")
                .font(.system(size: 80))
                .foregroundColor(.blue)
            
            Text("Hello, iOS!")
                .font(.largeTitle)
                .fontWeight(.bold)
            
            Text("第一个iOS应用已成功创建")
                .font(.body)
                .foregroundColor(.gray)
        }
        .padding()
    }
}

#Preview {
    ContentView()
}

同时确认 HelloWorldApp.swift 中的入口代码保持默认：

import SwiftUI

@main
struct HelloWorldApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

工程配置检查

在Xcode中点击左侧项目导航器顶部的蓝色项目图标，进入 Signing & Capabilities 标签页，确认以下配置：

Automatically manage signing 已勾选（模拟器运行不强制要求）
Bundle Identifier 显示为 com.example.HelloWorld
Deployment Target 设置为 iOS 16.0 或更高

运行与验证

在Xcode顶部工具栏的设备选择器中，选择一个iPhone模拟器（如iPhone 15 Pro）。
点击 Run 按钮（▶️）或按 Cmd + R 构建并运行。
观察Xcode底部的调试控制台，确认出现 Build succeeded 且无错误日志。

验证判定标准：

模拟器成功启动并加载应用，界面显示苹果Logo、"Hello, iOS!"标题和灰色副标题文字。
Xcode控制台无编译错误，仅有正常的系统日志输出。
点击模拟器中的Home键再重新打开应用，应用能正常恢复，无崩溃。

常见问题排查

模拟器无法启动：检查Xcode菜单 Window > Devices and Simulators 中是否有可用模拟器，若无则点击左下角"+"添加。
编译报错 "Cannot find 'ContentView' in scope"：确认两个Swift文件都在同一target下，且文件名与结构体名一致。
首次运行提示信任开发者：模拟器环境不会出现此问题；若在真机调试，需在设备设置中信任开发者证书。

至此，第一个iOS应用已创建完成，开发环境配置验证通过，后续案例将在此工程基础上逐步扩展功能。