這陣子工作比較忙,很多想法都先記在筆記裡,遲遲沒有整理成文章。直到最近接到一個需求:在 iOS 中呼叫 MusicBrainz,取得歌曲、歌手與專輯等完整資訊。趁著把環境跑通,我把整個流程整理出來,希望讓大家少踩一點坑。
MusicBrainz 可以把它理解成音樂領域的開放百科資料庫。只要提供歌曲名、歌手、發行時間等片段線索,就有機會查到更完整的作品資料。對喜歡音樂、又希望把媒體資訊整理乾淨的人來說,是很實用的服務。
建議使用 git clone 下載 MusicBrainz-objc,而不是直接下載 ZIP。因為後續編譯會用到子模組與 shell script,若缺少 git 資訊,容易出現找不到 submodule 或腳本執行失敗的問題。

打開工程後,選擇 libmusicbrainz-iphoneos scheme 並執行 Build。若曾經用 ZIP 解壓而導致腳本出錯,可以先執行 Clean,再重新建置。

建置成功後,可以在 Products 中透過 Show in Finder 找到輸出的靜態庫與標頭檔。

建立 MusicBrainzDemo 專案,把 Debug-iphoneos 或 Debug-iphonesimulator 下的 .a 檔案與 Headers 複製到 MusicBrainzDemo/MusicBrainzDemo 目錄。若沒有放在預期路徑,就必須另行設定 Header Search Paths。


在 Build Settings 中搜尋 Header Search Paths,加入 $(SDKROOT)/usr/include/libxml2,讓編譯器能找到 libxml2 的標頭檔。

由於類庫中有自行定義的 Category,也需要在 Other Linker Flags 加入 -all_load,否則可能出現方法找不到的錯誤。

最後在 Build Phases 中補上所需的函式庫與 framework。完成後,MusicBrainz 類庫就可以在專案中使用。

以下範例透過 MBID 查詢藝術家資料,並在成功回呼中印出名稱。
#import "ViewController.h"
#import "MB.h"
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
MBConnection *conn = [MBConnection connection];
MBRequest *req = [MBRequest lookupWithEntity:MBEntityArtist
mbid:@"86119d30-d930-4e65-a97a-e31e22388166"
incParameters:(MBIncParameterArtistRels | MBIncParameterReleaseGroups)];
void (^successBlock)(MBRequest *, MBMetadata *) = ^(MBRequest *request, MBMetadata *metadata) {
NSLog(@"%@", metadata.Artist.Name);
};
void (^failureBlock)(MBRequest *, NSError *, NSData *) = ^(MBRequest *request, NSError *error, NSData *data) {
NSLog(@"Error: %@", error);
};
[conn enqueueRequest:req onSuccess:successBlock onFailure:failureBlock];
}
@end
執行後,主控台會顯示請求流程與查詢結果。這個 Demo 雖然簡單,但已足以驗證網路請求、資料解析與回呼設計是否正確。