robrix

罗布里克斯：robius上建立的锈蚀矩阵客户端

Robrix是用Rust编写的矩阵聊天客户端，以演示Robius项目的功能，Robius是Rust中多平台应用程序开发的框架。 Robrix使用MakePad UI工具包编写。

▶q单击此处查看Robrix项目跟踪器！

笔记

配x Robrix是一个正在进行的工作，尚未支持所有矩阵聊天功能。

查看我们的最新演讲和演讲以获取更多信息：

• Robrix：一个纯锈多平台应用程序，用于聊天和超越（来自Gosim China 2024）
  • 视频：YouTube链接
  • 幻灯片：PowerPoint（25MB），PDF版本（6MB）
• Robrix：矩阵聊天客户端以及更多（来自Gosim Europe 2024）
  • 视频：YouTube链接，Bilibili链接
  • 幻灯片：PowerPoint（22MB），PDF版本（16MB）

下表显示了当前可以使用哪些主机系统来构建针对哪个目标平台的Robrix。

主机OS	目标平台	构建？	跑步？
macos	macos	✅	✅
macos	安卓	✅	✅
macos	ios	✅	✅
Linux	Linux	✅	✅
Linux	安卓	✅	✅
视窗	视窗	✅	✅
视窗	安卓	✅	✅

建筑和跑步

1. 首先，安装生锈。

2. 如果您在Windows上的Linux或WSL上构建，请安装所需的依赖项。否则，请继续步骤3。

   • openssl ， clang / libclang ， binfmt ， Xcursor / X11 ， asound / pulse 。

   在类似Debian的Linux发行版（例如Ubuntu）上，运行以下内容：

   sudo apt-get update
   sudo apt-get install libssl-dev libsqlite3-dev pkg-config binfmt-support libxcursor-dev libx11-dev libasound2-dev libpulse-dev

3. 然后，构建和运行Robrix（您可以选择添加--release ）：

   cargo run

   如果您想为快速自动蛋白提供用户名和密码，则可以在命令行上这样做。请注意，您只需要指定一次即可。成功登录后，Robrix将自动重新使用最新的用户，而无需指定用户的ID或密码。

   cargo run -- ' USERNAME ' ' PASSWORD ' [ ' HOMESERVER_URL ' ]

   • 请注意，如果您在命令行中输入密码，则应将其包装在单个引号（而不是双引号）中，以防止外壳将某些符号视为地球/正则符号图案。
   • HOMESERVER_URL参数是可选的，并且使用默认情况下使用"https://matrix-client.matrix.org/" 。
   • 矩阵HOMESERVER必须支持滑动同步，与元素X相同的要求。

为Android建造Robrix

1. 安装cargo-makepad构建工具：

   cargo install --force --git https://github.com/makepad/makepad.git --branch rik cargo-makepad

2. 使用cargo-makepad安装Android工具链，并使用完整的NDK：

   cargo makepad android install-toolchain --full-ndk

3. 使用cargo-makepad构建和运行Robrix：

   cargo makepad android run -p robrix --release

   • 您需要将实体Android设备与启用开发人员选项连接，或使用Android Studio启动模拟器。
     • API版本33或更高，即Android 13及以上。

功能状态跟踪器

这些通常按优先顺序排序。如果您有兴趣在这里提供任何帮助，请通过GitHub问题或我们的Robius Matrix频道与您联系。

基本房间的景观和基本动作

• 查看加入房间的清单
• 查看单个房间中事件的时间表
• 获取和展示房间的头像
• 获取用户配置文件（可显示名称）
• 缓存用户配置文件和化身
• 缓存以每室的方式获取媒体
• 获取并显示用户个人资料化身
• 向后分页，以查看房间的较旧历史
• 基于滚动位置/移动的动态向后分页：＃109
• 等待分页请求时加载动画：＃109
• 时间轴更新期间事件的稳定垂直位置
• 显示简单的明文消息
• 显示图像消息（PNG，JPEG）
• html（丰富的文本）格式用于消息主体
• 显示反应（注释）
• 处理单击时打开链接
• 更换明文超链接
• 显示上述消息的回复预览：＃82
• 发送独立消息
• 交互式反应按钮，发送反应：＃115
• 显示回复按钮，发送回复：＃83
• E2EE设备验证，解密消息内容：＃116
• 显示多媒体（音频/视频/GIF）消息事件：＃120
• 重新产生的时间表在整个时间表清除之后，重点放在旧事件上：＃103

辅助/管理员功能：登录，注册，设置

• 应用程序会话对磁盘的持久性：＃112
• 用户名/密码登录屏幕：＃113
• SSO，其他第三方Auth提供商登录屏幕：＃114
• 侧面面板显示详细的用户个人资料信息（单击其头像）
• 忽略和Unignore用户（请参阅已知问题）
• 连续“小”事件的可折叠/可扩展视图：＃118
• 用户设置屏幕
• 空间的专用视图
• 直接消息的专用视图（DMS）：＃139
• 链接预览以下消息：＃81
• 所有房间列表的关键字过滤器：＃123
• 房间内的搜索消息：＃122
• 室浏览器，搜索公共房间
• 房间创造
• 房间设置/信息屏幕
• 房间成员窗格
• 将事件保存/还原事件在应用程序关闭/start时在事件缓存中/从事件缓存：＃164

已知问题/问题

• 矩阵特定的链接尚未完全处理（https：//matrix.to/...）
• 忽略/Unigning用户清除所有时间表（请参阅：Matrix-Org/Matrix-Rust-SDK＃1703）;时间轴将使用逐渐的分页重新填写，但视图位置尚未保持

包装robrix用于在桌面平台上分发

提示

我们已经有可下载的Robrix的预制版本。

1. 安装cargo-packager ：

rustup update stable  # # Rust version 1.79 or higher is required
cargo +stable install --force --locked cargo-packager

对于后代，这些说明已在cargo-packager版本0.10.1上进行了测试，该版本需要Rust V1.79。

2. 使用启用makepad功能安装robius-packaging-commands板条箱：

cargo install --locked --git https://github.com/project-robius/robius-packaging-commands.git

3. 然后运行包装命令，该命令必须在发布模式下构建：

cargo packager --release # # --verbose is optional

特定于平台的考虑因素

请注意，由于平台限制，您目前只能构建：

• Linux OS机器上的Linux软件包
• Windows安装程序在Windows OS计算机上
• MacOS磁盘图像 / App Bundles在MacOS机器上
• MacOS计算机上的iOS应用程序。
• Android，在带有任何操作系统的机器上！

当MacOS包装Robrix时，还有一些其他注意事项：

重要的

您将看到一个.dmg窗口弹出 - 请搁置它，一旦包装过程完成，它将自动关闭。

提示

如果您收到以下错误：

 ERROR cargo_packager::cli: Error running create-dmg script: File exists (os error 17)

然后打开Finder并卸载任何与Robrix相关的磁盘映像，然后再次尝试上述cargo packager命令。

提示

如果您收到这样的错误：

 Creating disk image...
hdiutil: create failed - Operation not permitted
could not access /Volumes/Robrix/Robrix.app - Operation not permitted

然后，您需要将“应用程序管理”权限授予运行cargo packager命令的应用程序，例如，终端，Visual Studio Code等。为此，打开System Preferences → Privacy & Security → App Management ，然后单击相关应用程序旁边的切换开关以启用该许可。然后，再次尝试上述cargo packager命令。

命令完成后，您应该在dist/ Directory中看到Robrix.app和.dmg 。您可以立即双击Robrix.app Bundle以运行它，也可以双击.dmg文件

请注意， .dmg是在其他计算机上安装的要分配的，而不是.app 。

如果您想修改.dmg背景，则是用于生成MacOS .DMG背景图像的Google图纸文件。