Riot-Android
Riot 是一个 Android Matrix 客户端。
重要公告
核心团队现在主要在 RiotX 上工作。仍欢迎有关安全性问题(PR,问题)的新贡献。由于我们没有时间花在维护新功能上,因此其他问题可能很少解决。现在请捐助 RiotX!
贡献
如果您想在 Android 项目中贡献 Matrix,请访问 CONTRIBUTING.md!
构建说明
该客户端是一个标准的 android studio 项目。
如果要在命令行中使用 gradle 进行编译,请转到项目目录:
调试模式:
./gradlew assembleDebug
发布模式:
./gradlew assembleRelease
于是它应该构建项目(您需要具有正确的 android SDK)
重新编译提供的 aar 文件,直到获得 gradle
生成 olm-sdk.aar
sh build_olm_lib.sh
生成 matrix-sdk.aar
sh build_matrix_sdk_lib.sh
生成其他aar文件
sh build_jitsi_libs.sh
用 Riot-android 项目编译 matrix SDK sh set_debug_env.sh
使自己的味道
假设您的应用程序名为 MyRiot:您必须创建自己的样式。
修改 riot-android/vector/build.gradle
如果您打算使用 FCM,请在“productFlavors”部分中复制“app”组,否则请复制“appfdroid”。
例如,使用FCM,
appmyriot { applicationId "im.myriot" // use the version name versionCode rootProject.ext.versionCodeProp versionName rootProject.ext.versionNameProp buildConfigField "boolean", "ALLOW_FCM_USE", "true" buildConfigField "String", "SHORT_FLAVOR_DESCRIPTION", "\"F\"" buildConfigField "String", "FLAVOR_DESCRIPTION", "\"FDroid\"" }
- 如果您使用 FCM,请在此文件末尾复制 appImplementation,然后将 appImplementation 替换为 appmyriotImplementation。
- 如果不这样做,请更新‘if (!getGradle().getStartParameter().getTaskRequests().toString().contains("fdroid"))’以包括您的风格。
创建您的风格目录
- 如果使用 FCM,请复制 riot-android/vector/src/app 或 appfroid。
- 将其重命名为 appmyriot。
- 如果您使用 FCM,则需要生成自己的 google-services.json。
自定义您的口味
- 打开 riot-android/vector/src/appmyriot/AndroidManifest.xml
- 使用应用程序标记中的‘android:label="myRiot"" and "tools:replace="label"’将应用程序名称更改为 myRiot。
- 通过在此目录类路径中添加资源,可以自定义任何其他字段。
- 打开Android Studio,选择您的口味。
- 构建并运行该应用程序:您制作了第一个 Riot 应用程序。
您将需要管理自己的提供程序,因为已经使用了“im.vector”(请查看 VectorContentProvider 进行管理)。
使用自定义的 Google Play 链接自定义您的应用程序设置
可以将一些默认值设置为 Riot,并为 Google Play 链接设置一些其他参数。
- 使用https://developers.google.com/analytics/devguides/collection/android/v4/campaigns URL生成器(在底部)
- 使用其他参数设置“Campaign Content”(例如 is=http://my__is.org%26hs=http://my_hs.org )。请注意使用 %26 以转义&
- 支持的额外参数:
- is:身份服务器 URL
- hs:家用服务器 URL
- 生成定制链接
为了使此功能正常运行,可能必须从 Play 商店网站(而不是 Play 商店应用程序)安装该应用程序。
常问问题
支持的最低 Android 版本是多少?
最小的 SDK 是 16(android 4.1)
apk 是在哪里生成的?
Riot/build/outputs/apk
(The first version translated by vz on 2020.08.02)