Linphone is a free VoIP and video softphone based on the SIP protocol. Mirror of linphone-iphone (git://git.linphone.org/linphone-iphone.git)
Jehan Monnier
Latest commit 4f0666d Oct 22, 2018
Permalink
Failed to load latest commit information.
.tx translations May 24, 2018
Classes Remove rootca.pem from xcodeproj resources as it is now included in l… Oct 16, 2018
LiblinphoneTester fix crash in video testers Jun 18, 2018
Resources Add support for multiple image and text + image sending Jun 29, 2018
Settings/InAppSettings.bundle Add a new entry for H265 in video codecs view. Sep 12, 2018
TestsLiblinphone fix tester's build May 23, 2018
TestsUI Merge branch 'master' into dev_group_chat Dec 15, 2017
Tools repair make ipa Jun 26, 2018
cmake_builder update build Feb 9, 2018
doc add documentation Aug 12, 2016
latestCallsWidget fix crash with markAsRead when goToChatRoom and app is closed Jun 20, 2018
latestChatroomsWidget fix crash with markAsRead when goToChatRoom and app is closed Jun 20, 2018
linphone.xcodeproj Remove rootca.pem from xcodeproj resources as it is now included in l… Oct 16, 2018
linphoneExtension fix share file not from icloud Oct 8, 2018
richNotifications cleaned code Jul 2, 2018
submodules Merge branch 'hotfix/4.0.1' Oct 22, 2018
.git-pre-commit .git-pre-commit: update to have both diff patch and file patch Feb 8, 2016
.gitignore xcode: add sdk_download.sh script and use it in xcode if sdk is not y… Jul 25, 2016
.gitmodules Merge branch 'dev_group_chat' Aug 3, 2018
.travis.yml .travis.yml: do not mute make Jun 23, 2016
CHANGELOG.md Merge branch 'hotfix/4.0.1' Oct 22, 2018
CONTRIBUTING.md CONTRIBUTING.md: created file Dec 21, 2015
LICENCE Tests: restructure tests folder to get a constistent name convention Jul 9, 2015
README.md Revert "Update README.md" Jun 12, 2018
iTunesArtwork resources: add ipad specific images Feb 1, 2016
linphone-Info.plist Merge branch 'hotfix/4.0.1' Oct 22, 2018
linphone.entitlements remove useless configuration Jul 15, 2018
linphone_Prefix.pch Contact: factorize code to handle either native contacts and/or Linph… May 18, 2016
main.m UI: iPad version Dec 16, 2015
prepare.py disable static build of iOS SDK as it no longer works Jul 11, 2018

README.md

Build Status

Linphone is a free VoIP and video softphone based on the SIP protocol.

Dialer screenshot

How can I contribute?

Thanks for asking! We love pull requests from everyone. Depending on what you want to do, you can help us improve Linphone in various ways:

Help on translations

Top translations: linphone-ios

Interested in helping translate Linphone? Contribute on Transifex.

Report bugs and submit patchs

If you want to dig through Linphone code or report a bug, please read CONTRIBUTING.md first. You should also read this README entirely ;-).

How to be a beta tester ?

Enter the Beta :

  • Download TestFlight from the App Store and log in it with your apple-id
  • Send an email to linphone-iphone@belledonne-communications.com, with object : [Beta test - Request], where you precise your apple-id you logged in TestFlight with
  • You will receive an invitation code to the beta in the following days via your email associated to your apple-id
  • Enter the invitation code received into TestFlight
  • Download Linphone from TestFlight
  • And voilà ! TestFlight will send you a notification every time a new beta test is available.

Send a crash report :

  • It is done automatically by TestFlight

Report a bug :

  • Open Linphone
  • Go to Settings —> Advanced —> Send logs
  • An email to linphone-iphone@belledonne-communications.com is created with your logs attached
  • Fill in the bug description with :
    • What you were doing
    • What happened
    • What you were expecting
    • Approximately when the bug happened
  • Change the object to [Beta test - Bug report]
  • Send the mail

Building and customizing the SDK

Linphone for iPhone depends on liblinphone SDK. This SDK is generated from makefiles and shell scripts.

Steps to customize the liblinphone SDK options are:

  1. Install HomeBrew, a package manager for OS X (MacPorts is supported but deprecated).
  2. Install Linphone dependencies: open iTerm.app in the current directory and list dependencies to install using: ./prepare.py
  3. Reorder your path so that brew tools are used instead of Apple's ones which are obsolete: export PATH=/usr/local/bin:$PATH
  4. Build SDK (see below for options and explanations): ./prepare.py -c && ./prepare.py && make

For instance to generate the liblinphone multi-arch SDK in GPL mode, simply invoke:

    ./prepare.py [options] && make

The resulting SDK is located in liblinphone-sdk/ root directory.

Incorporating our SDK in your project

After the SDK has been built, add all the .framework files located in liblinphone-sdk/apple-darwin/Frameworks to your XCode project Embedded Frameworks and linked binaries. Make sure that your project FRAMEWORK_SEARCH_PATHS contains "$(PROJECT_DIR)/liblinphone-sdk/apple-darwin/Frameworks" Make sure that your project LD_RUNPATH_SEARCH_PATHS contains "$(inherited) @executable_path/Frameworks"; 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 the Tools folder of linphone-iphone root directory.

Licensing: GPL third parties versus non GPL third parties

This SDK can be generated in 2 flavors:

  • GPL third parties enabled means that liblinphone includes GPL third parties like FFmpeg. If you choose this flavor, your final application must comply with GPL in any case. This is the default mode.

  • NO GPL third parties means that Linphone will only use non GPL code except for liblinphone, mediastreamer2, oRTP and belle-sip. If you choose this flavor, your final application is still subject to GPL except if you have a commercial license for the mentioned libraries. To generate the liblinphone multi arch SDK without GPL third parties, invoke:

      ./prepare.py -DENABLE_GPL_THIRD_PARTIES=NO -DENABLE_FFMPEG=NO [other options] && make
    

Customizing features

You can enable non-free codecs by using -DENABLE_NON_FREE_CODECS=ON and -DENABLE_<codec>=ON. To get a list of all features, the simplest way is to invoke prepare.py with --list-features:

    ./prepare.py --list-features

You can for instance enable X264 using:

    ./prepare.py -DENABLE_NON_FREE_CODECS=ON -DENABLE_X264=ON [other options]

Built architectures

4 architectures currently exists on iOS:

  • 64 bits ARM64 for iPhone 5s, iPad Air, iPad mini 2, iPhone 6, iPhone 6 Plus, iPad Air 2, iPad mini 3.
  • 32 bits ARMv7 for older devices.
  • 64 bits x86_64 for simulator for all ARM64 devices.
  • 32 bits i386 for simulator for all ARMv7 older devices.

Note: We are not compiling for the 32 bits i386 simulator by default because Xcode default device (iPhone 6) runs in 64 bits. If you want to enable it, you should invoke prepare.py with i386 argument: ./prepare.py i386 [other options].

Upgrading your iOS SDK

Simply re-invoking make should update your SDK. If compilation fails, you may need to rebuilding everything by invoking:

    ./prepare.py -c && ./prepare.py [options] && make

Building the application

After the SDK is built, just open the Linphone Xcode project with Xcode, and press Run.

Note regarding third party components subject to license

The liblinphone SDK is compiled with third parties code that are subject to patent license, specially: AMR, SILK G729 and H264 codecs. Linphone controls the embedding of these codecs by generating dummy libraries when there are not available. You can enable them using prepare.py script (see -DENABLE_NON_FREE_CODECS=OFF option). Before embedding these 4 codecs in the final application, make sure to have the right to do so.

Testing the application

We are using the KIF framework to test the UI of Linphone. It is used as a submodule (instead of CocoaPods) for ease.

Simply press ⌘U and the default simulator / device will launch and try to pass all the tests.

Limitations and known bugs

  • Video capture will not work in simulator (not implemented in it).

Debugging the SDK

Sometime it can be useful to step into liblinphone SDK functions. To allow Xcode to enable breakpoint within liblinphone, SDK must be built with debug symbols by using option --debug:

    ./prepare.py --debug [other options] && make

Debugging mediastreamer2

For iOS specific media development like audio video capture/playback it may be interesting to use mediastream test tool. You can build it using the following:

    ./prepare.py -G Xcode -g && make
    # then open the project for a given architecture (here x86_64, to run on simulator):
    open WORK/ios-x86_64/Build/linphone_builder/EP_linphone_builder.xcodeproj

Then you can select mediastream target and launch it on device. You can configure scheme to pass custom parameters.

Quick UI reference

  • The app is contained in a window, which resides in the MainStoryboard file.

  • The delegate is set to LinphoneAppDelegate in main.m, in the UIApplicationMain() by passing its class

  • Basic layout:

      MainStoryboard
              |
              | (rootViewController)
              |
          PhoneMainView ---> view |--> app background
              |                   |
              |                   |--> statusbar background
              |
              | (mainViewController)
              |
          UICompositeView : TPMultilayout
                      |
                      |---> view  |--> statusBar
                                  |
                                  |--> contentView
                                  |
                                  |--> tabBar
    

When the application is started, the phoneMainView gets asked to transition to the Dialer view or the Assistant view. PhoneMainView exposes the -changeCurrentView: method, which will setup its Any Linphone view is actually presented in the UICompositeView, with or without a statusBar and tabBar.

The UICompositeView consists of 3 areas laid out vertically. From top to bottom: StatusBar, Content and TabBar. The TabBar is usually the UIMainBar, which is used as a navigation controller: clicking on each of the buttons will trigger a transition to another "view".