It seems the documentation for CocoaPods for RealmSwift may-be out of date when Xcode 8.1+ and Swift 3 is used. Step 3 is no more needed and you should skip it for this case.
i.e. you should now use (example):
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
target 'RealmProjectAzam' do
use_frameworks!
pod 'RealmSwift'
end
Edit - addition information:
Please note, after the above question has been posted, there was some additional discussion incl. Realm and the result is that Realm (thanks @realm!) has adjusted its Swift documentation to better face the above issue. Please see the updated instructions for Cocoapods installation at realm.io
In short, to "solve" the above issue please:
Run pod repo update to make CocoaPods aware of the latest available Realm versions.
'2.3' #or '3.0'- obviously you have to chose the version, which you'd like to use: 2.3 or 3.0 - Marin Todorov