Preparing examples for building
Building with local SDK archive
1. Install Cocoapods to build dependencies
sudo gem install cocoapods
2. Download the source code of the examples for Mac
git clone https://github.com/flashphoner/wcs-ios-sdk-samples.git
3. Download and unpack the iOS SDK
wget http://flashphoner.com/downloads/builds/flashphoner_client/wcs-ios-sdk/2.6/WCS-iOS-SDK-2.6.x.tar.gz tar -xvzf WCS-iOS-SDK-2.6.x.tar.gz
4. After unpacking, there are the following frameworks:
- two frameworks in builds before 2.6.86
FPWCSApi2.framework FPWCSApi2Swift.xcframework
- three frameworks since build 2.6.86
FPWCSApi2.framework FPWCSApi2Swift.xcframework WebRTC.xcframework
- since build 2.6.95 Objective C framework is shipped as XCFramework like others
FPWCSApi2.xcframework FPWCSApi2Swift.xcframework WebRTC.xcframework
- since build 2.6.97 SDK archive contains unpacked Cocoapods bundles
FPWCSApi2 FPWCSApi2Swift FPWebRTC
5. Copy the unpacked frameworks to the sample folder
- iOS SDK builds before 2.6.97
mkdir -p wcs-ios-sdk-samples/Frameworks cp -R FPWCSApi2.xcframework FPWCSApi2Swift.xcframework WebRTC.xcframework wcs-ios-sdk-samples/Frameworks
- iOS SDK builds since 2.6.97
mkdir -p wcs-ios-sdk-samples/sdk/fp_wcs_api2/Pods cp -R FPWCSApi2 FPWCSApi2Swift WebRTC wcs-ios-sdk-samples/sdk/fp_wcs_api2/Pods cd wcs-ios-sdk-samples mv Podfile Podfile.public mv Podfile.local Podfile
6. As a result, we have got the sample folder with the framework (iOS SDK). Now we can start building.
7. Run Cocoapods
pod install
Building with SDK from Cocoapods
This way is preferrable since iOS SDK build 2.6.97
1. Install Cocoapods to build dependencies
sudo gem install cocoapods
2. Download the source code of the examples for Mac
git clone https://github.com/flashphoner/wcs-ios-sdk-samples.git
3. Run Cocoapods (this step may take a time because FPWebRTC framework is slightly fat)
pod install
Building and launching examples using Xcode
1. Now, as soon as all dependencies are ready, open workspace in Xcode.
Important! You should open the workspace, not the project file. Otherwise, the build may be broken.
2. On General page for each example set the checkbox Automatically manage signing and set iPhone developer certificate.
6. For Two Way Streaming example choose target Generic iOS Device and start building from the Product - Build menu. Then connect your iPhone or iPad via USB and choose it to run the example.
7. After successful deployment and launch, the debug information is displayed in the lower part. This means, the Media Devices example has been correctly installed to iPhone or iPad and is running.
8. On iPhone, you should see the interface of the application you can start testing using the WCS server
9. Connect to the server and send a video stream from the web camera to the iPhone.
So, we have built Two Way Streaming example on Mac OS Mojave using Xcode 10.1 from the source code using the iOS SDK (FPWCSApi2.framework) and executed this example on iPhone 6. The example demonstrated successful streaming of a video through Web Call Server 5.