From version < 27.1 >
edited by Danmei Chen
on 2019/05/28 11:42
To version < 27.2 >
edited by Danmei Chen
on 2019/05/29 15:30
< >
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -10,38 +10,85 @@
10 10  
11 11  == What's new about SDK ==
12 12  
13 -As of today, integrating liblinphone sdk into a third party application is done by either compiling an sdk from the source or using a pre-built SDK from: [[http:~~/~~/www.linphone.org/technical-corner/liblinphone>>http://www.linphone.org/technical-corner/liblinphone]] . To continue to make IOS and macOS developer live easier, we now provide a Cocoapods based integration process. Cocoapods is a "dependency manager for Swift and Objective-C" which is now a de-facto standard in the Apple developer world. With Cocoapods, integrating liblinphone to an Xcode based application can be achieved like any "Pods" without any liblinphone's specific procedures.
13 +As of today, integrating liblinphone sdk into a third party application is done by either compiling an sdk from the source or using a pre-built SDK from: [[here>>http://www.linphone.org/releases/ios/]] . To continue to make IOS and macOS developer live easier, we now provide a Cocoapods based integration process. Cocoapods is a "dependency manager for Swift and Objective-C" which is now a de-facto standard in the Apple developer world. With Cocoapods, integrating liblinphone to an Xcode based application can be achieved like any "Pods" without any liblinphone's specific procedures.
14 14  
15 -== Using a pre-compiled SDK ==
15 +== Documentation of SDK ==
16 16  
17 -If you do not need to build the SDK manually, you can download a pre-compiled SDK [[here>>http://www.linphone.org/releases/ios/]].
17 +You can find the liblinphone API documentation of liblinphone [[here>>http://www.linphone.org/docs/liblinphone/modules.html]].
18 18  
19 -The SDKs available correspond to our AppStore releases and liblinphone-iphone-sdk-latest.zip represents the SDK of our most recent release.
19 +== Use SDK in an Objective-C Xcode project ==
20 20  
21 -Once the SDK is downloaded you can unzip it and put it in the root directory of your XCode Project.
21 +For example, the name of this project is "Myproject"
22 22  
23 -== Building the SDK manually ==
23 +open Myproject/, use commands:
24 24  
25 -Go to your linphone-iphone repository and run the following commands to update your submodules and build the SDK :
25 +{{code}}
26 +pod init
27 +{{/code}}
26 26  
29 +You will get Podfile, change the context. You must add your Cocoapods repo in it. For example:
30 +
27 27  {{code}}
28 -git submodule update --recursive --init
29 -./prepare.py -c
30 -./prepare.py
31 -make
32 +# Uncomment the next line to define a global platform for your project
33 +
34 +##For macosx
35 +# platform :osx, '10.9'
36 +#source "https://gitlab.linphone.org/BC/public/podspec-macos.git"
37 +
38 +#For iOS
39 +platform :ios, '9.0'
40 +source "https://gitlab.linphone.org/BC/public/podspec.git"
41 +
42 +target 'Myproject' do
43 + use_frameworks!
44 +
45 + # Pods for Myproject
46 + pod 'linphone-sdk' , '4.2'
47 +end
48 +
32 32  {{/code}}
33 33  
34 -The built of the SDK creates a folder named liblinphone-sdk with the binaries in your project's root directory.
51 + Sometimes you may need to update the liblinphone version, you can do
35 35  
36 -== Incorporating the SDK in a project ==
53 +{{code}}
54 +pod repo update
55 +pod install
56 +{{/code}}
37 37  
38 -After the SDK has been built, add all the `.framework` files located in `liblinphone-sdk/apple-darwin/Frameworks` to your XCode project Embedded Frameworks.
39 -Add a Run Script step to your build steps, put it after your step to embed frameworks, set it to use our `deploy.sh` script located in `liblinphone-sdk/apple-darwin/Tools`.
58 +== Use SDK in a Swift Xcode project ==
40 40  
41 -== Using the SDK ==
60 +Do the same things as the section: Use SDK in an Objective-C Xcode project, except add more pod in Podfile
42 42  
43 -You can find the liblinphone API documentation of liblinphone [[here>>http://www.linphone.org/docs/liblinphone/modules.html]].
62 +{{code}}
63 +pod 'linphonesw'
64 +{{/code}}
44 44  
66 +== Use local SDK ==
67 +
68 +You may want to use a local sdk, then change Podfile
69 +
70 +{{code}}
71 +pod 'linphone-sdk', :path=> '<<SDK PATH>>'
72 +{{/code}}
73 +
74 +=== Using a pre-compiled SDK ===
75 +
76 +If you do not need to build the SDK manually, you can download a pre-compiled SDK [[here>>http://www.linphone.org/releases/ios/]].
77 +
78 +The SDKs available correspond to our AppStore releases and liblinphone-iphone-sdk-latest.zip represents the SDK of our most recent release.
79 +
80 +Once the SDK is downloaded you can unzip it.
81 +
82 +=== Building the SDK manually ===
83 +
84 +Clone the linphone-sdk repository from out gitlab:
85 +
86 +{{code}}
87 + git clone https://gitlab.linphone.org/BC/public/linphone-sdk.git --recursive
88 +{{/code}}
89 +
90 +Follow the instructions in the linphone-sdk/README file to build the SDK.
91 +
45 45  = Handling liblinphone log =
46 46  
47 47  In order to see liblinphone logs in your IOS app (for example in your Xcode console) follow these steps :