27、使用Git进行版本控制：iOS声音录制应用开发全流程

最新推荐文章于 2026-06-22 12:13:59 发布

原创最新推荐文章于 2026-06-22 12:13:59 发布 · 57 阅读

0 GEO检测

精通Xcode：从入门到发布专栏收录该内容

34 篇文章 ¥499.90

订阅专栏¥69.90

会员秒杀 ¥9.9 重磅福利

超级会员免费看

使用Git进行版本控制：iOS声音录制应用开发全流程

1. 创建项目

本项目适合使用单视图应用模板，其核心功能是利用iOS设备的内置麦克风录制声音并进行回放。以下是创建项目的具体步骤：
1. 打开Xcode，通过“File ➤ New ➤ New Project”（快捷键⌘+Shift+N）或者在欢迎界面选择“Create A New Xcode Project”（快捷键⌘+Shift+1）来创建新项目。
2. 选择单视图应用模板，然后点击“Next”。
3. 将项目命名为“HearMeNow”，填入个人信息，确保“Devices”设置为“iPhone”，其他选项保持默认，点击“Next”。
4. 在保存对话框底部勾选“Source Control”，这表明项目将使用版本控制。若没有搭建用于存放Git仓库的服务器，可从下拉列表中选择“My Mac”来在本地创建Git仓库。确保设置与相关示例一致后，点击“Create”。

创建好项目和本地Git仓库后，从菜单栏选择“Source Control”，此时你会看到当前工作在“master”分支，这是项目初始的正常状态。接着，从“Source Control”菜单中选择“History”，这里能看到项目在版本控制下的历史记录，项目创建时会自动生成一个初始快照，即“初始提交”，查看完后点击“Done”关闭对话框。

2. AVFoundation框架简介

在开始构建项目界面之前，先来了解一下AVFoundation框架。尽管有专门的音频和视频框架，但AVFoundation提供了一组强大的类，是其他相关框架的基础。它可用于iOS和OS X开发，主要支持基于时间的音频和视频功能，如各种媒体类型的录制和回放。

在本应用中，需要将视图控制器设置为 AVAudioPlayerDelegate 和 AVAudioRecorderDelegate ，这样就能使用 AVAudioPlayer 和 AVAudioRecorder 类。只需在视图控制器中使用 import 语句即可将AVFoundation框架添加到项目中，无需手动添加。

3. 构建界面

应用的界面非常简单，包含一个标签和两个按钮，分别用于录制/停止录制和播放/停止播放，具体操作步骤如下：
1. 从项目导航器中打开“Main.storyboard”。
2. 由于项目基于单视图应用模板创建，故事板上已有一个视图。从对象库中拖入一个标签到视图上，将其移动到视图顶部，待出现蓝色参考线后释放，使用标签两侧的手柄调整宽度，使其与左右参考线对齐。
3. 打开属性检查器，将标签的“Text”属性从“Label”改为“Hear me now…”，并将对齐方式设置为居中。
4. 从对象库中拖入两个按钮，将它们上下排列。按照调整标签的方式调整按钮的宽度，使其与参考线对齐。在属性检查器中，将上方按钮命名为“Record”，下方按钮命名为“Play”。
5. 重新调整两个按钮的位置，使其再次居中，完成后的界面应与示例一致。
6. 点击“Resolve Auto Layout Issues”按钮，然后选择“All Views”下的“Add Missing Constraints”，以固定界面元素的位置。
7. 打开辅助编辑器，确保与故事板并排显示的是“ViewController.swift”。
8. 从“Record”按钮进行Control - 拖动操作，创建一个名为“recordButton”的输出口；对“Play”按钮重复此操作，创建名为“playButton”的输出口。
9. 再次对每个按钮进行Control - 拖动操作，为“Record”按钮创建名为“recordPressed”的操作，为“Play”按钮创建名为“playPressed”的操作。
10. 切换回标准编辑器，从项目导航器中打开“ViewController.swift”。在文件头部添加以下代码，导入AVFoundation框架并应用两个协议：

import UIKit
import AVFoundation

class ViewController: UIViewController, AVAudioPlayerDelegate, AVAudioRecorderDelegate {
    @IBOutlet weak var recordButton: UIButton!
    @IBOutlet weak var playButton: UIButton!
    @IBAction func recordPressed(sender: AnyObject) {
    }
    @IBAction func playPressed(sender: AnyObject) {
    }
}

4. 添加实例变量和方法

在应用中，还需要添加一些实例变量和方法，具体如下：
在文件顶部添加以下实例变量：

class ViewController: UIViewController, AVAudioPlayerDelegate, AVAudioRecorderDelegate {
    var hasRecording = false
    var soundPlayer : AVAudioPlayer?
    var soundRecorder : AVAudioRecorder?
    var session : AVAudioSession?
    var soundPath : String?

    @IBOutlet weak var recordButton: UIButton!
    @IBOutlet weak var playButton: UIButton!
}

在 viewDidLoad 方法中初始化 session 、 soundPath 和 soundRecorder 对象：

override func viewDidLoad() {
    super.viewDidLoad()
    soundPath = "\(NSTemporaryDirectory())hearmenow.wav"
    let url = NSURL(fileURLWithPath: soundPath!)
    session = AVAudioSession.sharedInstance()
    session?.setActive(true, error: nil)
    var error : NSError?
    session?.setCategory(AVAudioSessionCategoryPlayAndRecord, error: &error)
    soundRecorder = AVAudioRecorder(URL: url, settings: nil, error: &error)
    if(error != nil) {
        println("Error initializing the recorder: \(error)")
    }
    soundRecorder?.delegate = self
    soundRecorder?.prepareToRecord()
}

为“Record”按钮的 recordPressed 操作添加代码：

@IBAction func recordPressed(sender: AnyObject) {
    if(soundRecorder?.recording == true) {
        soundRecorder?.stop()
        recordButton.setTitle("Record", forState: UIControlState.Normal)
        hasRecording = true
    } else {
        session?.requestRecordPermission(){
            granted in
            if(granted == true) {
                self.soundRecorder?.record()
                self.recordButton.setTitle("Stop", forState: UIControlState.Normal)
            } else {
                println("Unable to record")
            }
        }
    }
}

为“Play”按钮的 playPressed 操作添加代码：

@IBAction func playPressed(sender: AnyObject) {
    if(soundPlayer?.playing == true) {
        soundPlayer?.pause()
        playButton.setTitle("Play", forState: UIControlState.Normal)
    } else if (hasRecording == true) {
        let url = NSURL(fileURLWithPath: soundPath!)
        var error : NSError?
        soundPlayer = AVAudioPlayer(contentsOfURL: url, error: &error)
        if(error == nil) {
            soundPlayer?.delegate = self
            soundPlayer?.play()
        } else {
            println("Error initializing player \(error)")
        }
        playButton.setTitle("Pause", forState: UIControlState.Normal)
        hasRecording = false
    } else if (soundPlayer != nil) {
        soundPlayer?.play()
        playButton.setTitle("Pause", forState: UIControlState.Normal)
    }
}

最后，添加两个委托方法，用于在录制或播放完成时更改按钮文本：

func audioRecorderDidFinishRecording(recorder: AVAudioRecorder!, successfully flag: Bool) {
    recordButton.setTitle("Record", forState: UIControlState.Normal)
}

func audioPlayerDidFinishPlaying(player: AVAudioPlayer!, successfully flag: Bool) {
    playButton.setTitle("Play", forState: UIControlState.Normal)
}

5. 运行应用

完成上述代码编写后，应用即可运行。若要测试应用的完整功能，需要使用物理iOS设备。可通过点击方案旁边的模拟器名称，从可用设备列表中选择物理设备（前提是设备已通过USB线连接到Mac并已做好开发准备）。

运行应用后，你将得到一个简单但有效的声音录制器。点击“Record”按钮说话，点击“Stop”后声音将保存到设备上可供回放。不过，该应用使用单一文件名，每次点击“Record”都会覆盖之前的文件。

6. 提交更改

在对受版本控制的项目进行更改时，虽然保存文件或运行应用时更改会在本地生效，但这些更改直到执行“提交”操作才会保存到Git仓库中。提交操作会在Git仓库中创建项目的更新快照，为项目创建一个时间点的参考，方便随时回溯。

当项目完成第一个阶段目标时，是提交项目并更新Git仓库的好时机。选择“Source Control ➤ Commit”（快捷键⌘+⌥+C），此时会显示项目中所有更改文件的详细信息，主要关注以下四个关键点：
- 修改项列表 ：列出项目中所有更改的项，有项目视图（默认）、文件视图（在Finder文件夹结构中显示修改文件）和扁平视图（无结构地列出项）三种查看方式，每个项旁边有复选框，可取消勾选以排除该项。
- 高亮更改 ：选择一个项时，会显示自初始提交以来该项的更改内容，每个更改都会高亮显示，能看到原始文件的修改点。
- 更改编号 ：Xcode会动态识别和分组每个修改项中的更改，方便在提交时忽略或丢弃特定更改。点击编号项可看到相关操作选项，列表底部的数字表示可单独处理的更改数量，还有步进控件可按顺序切换更改。
- 提交消息 ：提交修改到Git时，添加解释修改内容的消息很重要，这样其他用户能了解具体更改情况。

在提交消息框中添加注释解释更改内容，然后点击右下角的“Commit 2 Files”按钮。提交完成后，项目导航器中之前带有“M”符号（表示自上次提交到Git仓库后已修改）的项目项将不再显示该符号。从“Source Control ➤ History”中可以看到项目历史记录，现在有了初始提交和刚完成的提交两条记录。

7. 使用版本编辑器查看更改

版本控制的一个重要优势是为多人协作开发提供了保障。当提交之间出现问题时，能够查看更改内容并找出问题责任人至关重要。除了标准编辑器和辅助编辑器，Xcode还提供了版本编辑器，它是编辑器组中的第三个图标，点击旁边的小箭头可看到有“Comparison”（默认）、“Blame”和“Log”三种视图。

若要使用比较视图，先从项目导航器中选择“ViewController.swift”，再点击Xcode中的版本编辑器图标。该视图与提交过程中的主要部分类似，但更具灵活性，其核心功能体现在编辑器底部的工具栏上。可以配置左右窗格来显示所选文件的不同版本，以左窗格为例，包含代表工作区项目的“HearMeNow”、代表所选分支的“Master”和代表所选文件版本的“Local Revision”三个部分，右窗格显示的是文件上次提交时的版本。

从右窗格的工具栏中选择“Master”分支项，能看到可供比较的文件版本。若要查看自初始提交以来的更改，选择最旧的版本，此时会显示两个版本之间的代码差异对比。需要注意的是，与提交时不同，在版本编辑器中不能排除已提交的代码。

Xcode还提供了版本时间线功能，方便比较所选文件的不同版本。点击编辑器底部工具栏中央类似时钟的时间线查看器图标，两个窗格之间的区域将显示版本时间线，这与Mac上的Time Machine恢复文件功能类似。

使用Git进行版本控制：iOS声音录制应用开发全流程

8. 版本编辑器各视图详解

mermaid流程图如下：

graph LR
    A[选择版本编辑器] --> B{选择视图}
    B --> C[Comparison视图]
    B --> D[Blame视图]
    B --> E[Log视图]
    C --> F[配置窗格对比代码]
    D --> G[查看每行代码修改人]
    E --> H[查看提交历史记录]