How belledonnecommunications/linphone-android works
Project type and purpose
• This is Linphone-Android, an open-source SIP softphone client for Android (voice/video calls + messaging).
• It is a full-blown native mobile application (no web or server code here) that embeds a native SIP/media stack via an AAR from the linphone-sdk.
File structure
• Top level
• app/ – the Android Studio Gradle module containing all code & resources
• build scripts (build.gradle.kts, settings.gradle.kts, gradle wrapper, CI config, Docker files)
• metadata/ – Play Store & F-Droid descriptions
• app/src/main/java/org/linphone
• core/ – wrappers around the native SIP core: services, context, preferences, VFS, file transfer, push handling
• ui/ – subdivided into assistant, call, conference, chat, contacts, fileviewer, main, meetings, recordings, settings, welcome
– each feature follows MVVM: Fragment/Activity → ViewModel → Model
• compatibility/ – Android OS version abstractions
• notifications/, telecom/ – Android platform integrations (InCallService, TelecomManager, NotificationReceiver)
• utils/ – shared helpers (AudioUtils, FileUtils, Event, ToastUtils, etc.)
• Configuration & assets – linphonerc default values, google-services.json for Firebase, proguard rules
README for additional insights
• Confirms it pulls a Linphone-SDK AAR (native C/C++ SIP stack) at build time.
• Supports Firebase push notifications for incoming calls/messages.
• Targets Android 9.0+ and uses NDK for native symbol generation.
• Uses AndroidX (Navigation Component, ViewModel, LiveData).
Attention to detail
• Navigation graphs as part of the UI layer or as an overlay
• JNI bridge explicitly between Core API Layer and native library
• Background receivers/services and their triggers (system boot, push arrival)
• Persistent storage components and where data flows for logs and settings