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圖紙文件。