Linphone是一款开源的IP语音和视频通话以及即时通讯软件。

它完全基于SIP协议，用于所有通话、在线状态和即时通讯功能。

详细介绍可以在Linphone网站上查看。

如何获取

你也可以从我们的网站下载经我们签名的APK文件。

许可证

Linphone采用双重许可，可以选择以下两种方式之一：

根据GNU/GPLv3许可证，免费使用（开源）。在使用前，请确保你理解并同意该许可证的条款（详见LICENSE文件）。
根据专有许可证，付费使用，可用于闭源应用程序。如有任何关于费用和服务的问题，请联系Belledonne Communications。

文档

支持的功能和RFC：https://www.linphone.org/technical-corner/linphone/features
Linphone公共wiki：https://wiki.linphone.org/xwiki/wiki/public/view/Linphone/
教程：https://gitlab.linphone.org/BC/public/tutorials/-/tree/master/android/kotlin

新特性

应用程序已完全用Kotlin重写，使用了现代组件，如Navigation、Data Binding、View Models、协程等...
查看CHANGELOG文件以获取更详细的列表。基于此的第一个linphone-android版本将是4.5.0，使用5.0.0 SDK。

我们也在重新开始翻译工作，因此暂时支持的语言会减少。
如果你想贡献，欢迎参与，请查看下面的翻译部分。

从5.0.0 SDK开始，不再支持org.linphone.legacy flavor（如果你还没有将应用程序代码迁移到新版本）。

示例项目已被移除，我们现在建议你查看我们的教程。

构建应用

如果你有Android Studio，只需打开项目，等待gradle同步完成，然后构建/安装应用即可。
它会从我们的Maven仓库下载linphone库作为AAR文件，因此你无需自己构建任何内容。

如果你没有Android Studio，可以使用gradle构建和安装应用：

./gradlew assembleDebug

将编译APK文件（如果你想构建发布包，则使用assembleRelease），然后

./gradlew installDebug

安装上一步生成的APK（如果你构建了发布包，则使用installRelease）。

APK文件存储在./app/build/outputs/apk/debug/和./app/build/outputs/apk/release/目录中。

构建发布版AppBundle时，请使用releaseAppBundle目标而不是release。
同时确保你已安装NDK，并设置了一个名为ANDROID_NDK_HOME的环境变量，其中包含NDK的路径。
这是为了能够将原生库符号包含到Play Store的应用包中。

构建本地SDK

从我们的gitlab克隆linphone-sdk仓库：

git clone https://gitlab.linphone.org/BC/public/linphone-sdk.git --recursive

按照linphone-sdk/README文件中的说明构建SDK。
在$GRADLE_USER_HOME（通常是~/.gradle/）中创建或编辑gradle.properties文件，添加linphone-sdk构建目录的绝对路径，例如：

LinphoneSdkBuildDir=/home/<username>/linphone-sdk/build/

在Android Studio中重新构建应用。

原生调试

从Android Studio的SDK Tools中安装LLDB。
在Android Studio中转到Run->Edit Configurations->Debugger。
选择'Dual'或'Native'，并添加linphone-sdk调试库的路径（例如build/libs-debug/）。
打开原生文件并在其中设置断点。
确保在app/build.gradle脚本中使用调试版AAR，而不是发布版（默认情况下，即使是调试APK flavor也使用发布版AAR以加快构建速度）。
调试应用。

已知问题

如果遇到以下构建问题AAPT: error: resource drawable/linphone_logo_tinted (aka org.linphone:drawable/linphone_logo_tinted) not found，请删除app/src/main/res/xml/contacts.xml文件（你可以使用git clean -f命令简单地完成此操作），然后重新开始构建。
如果在应用启动时遇到couldn't find "libc++_shared.so"崩溃，只需在Android Studio中清理项目（在Build菜单下）并重新构建。同时检查你是否使用-DLINPHONESDK_ANDROID_ARCHS=armv7,arm64,x86,x86_64 cmake参数为正确的CPU架构构建了SDK。
当应用在安装后立即由Android Studio启动时，推送通知可能无法工作。从最近活动视图中移除应用，然后使用启动器图标重新启动应用以解决此问题。

故障排除

行为问题

在我们的Github仓库提交问题时，请遵循模板并附上相应的库日志：

要启用日志，请转到设置 -> 高级并切换调试模式。如果日志已启用，请先使用"关于"页面上的重置日志按钮清除它们。
然后重启应用，重现问题并使用高级设置页面上的发送日志按钮上传日志。
最后粘贴上传日志的链接（成功上传后链接已自动复制到剪贴板）。

原生崩溃

首先，为了能够获得符号化的堆栈跟踪，你需要我们库的调试版本。

如果你没有本地构建SDK（参见构建本地SDK），以下是获取方法：

前往我们的maven仓库，进入linphone-android-debug目录。
下载与生成崩溃堆栈跟踪时使用的AAR完全相同版本的AAR文件。
将AAR解压到您计算机上的某个位置（它实际上是一个简单的ZIP文件，尽管没有扩展名）。库文件存储在jni文件夹中（通常每个架构都有一个目录，如arm64-v8a、armeabi-v7a、x86_64和x86）。
为了与本地构建的SDK保持一致，将jni目录重命名为libs-debug。

现在您需要ndk-stack工具，可能还需要adb logcat。

如果您的计算机不用于Android开发，可以从Google网站的Command line tools only部分下载这些工具。

获得调试库和适当的工具后，您可以使用ndk-stack工具来符号化您的堆栈跟踪。请注意，您还需要知道所使用库的架构（armv7、arm64、x86等）。

如果您知道设备的CPU架构（如果是最新设备，很可能是arm64），可以使用以下命令从连接到计算机的设备获取堆栈跟踪：

adb logcat -d | ndk-stack -sym ./libs-debug/arm64-v8a/

如果不知道CPU架构，请使用以下命令：

adb logcat -d | ndk-stack -sym ./libs-debug/`adb shell getprop ro.product.cpu.abi | tr -d '\r'`

警告：在重现崩溃之前，此命令不会打印任何内容！

创建具有不同包名的APK

只需编辑app/build.gradle文件并更改packageName变量的值。由于gradle和Android的manifestPlaceholders功能，下一次构建将自动在所有地方使用此值。

您可能已经注意到，Android Studio安装的应用程序包名为org.linphone.debug。如果您以release模式构建应用程序，包名将是org.linphone。

如果在构建时遇到以下错误：

Execution failed for task ':app:processDebugGoogleServices'.
> No matching client found for package name 'your package name'

请确保已用您自己的文件（包含您的包名）替换了app/google-services.json文件。如果您没有这样的文件，请删除我们的文件。

Firebase推送通知

现在Google Cloud Messaging已被弃用，并将于2019年4月11日完全移除，使用推送通知的唯一官方方式是通过Firebase。

然而，要使Firebase推送通知工作，项目需要有一个包含配置的app/google-services.json文件。我们已经存档了我们自己的文件，因此您可以构建您的linphone-android应用程序，并仍然从我们的免费SIP服务（sip.linphone.org）接收推送通知。如果您删除它，您将不会收到任何推送通知。

如果您有自己的推送服务器，请用您自己的文件替换此文件。