wire android

線™

該存儲庫是 Wire 原始碼的一部分。您可以在wire.com 上或聯絡[email protected] 找到更多資訊。

您可以在 github.com/wireapp/wire 找到已發佈的原始程式碼，並在 https://wire.com/en/download/ 找到最新版本的 apk。

有關許可信息，請參閱隨附的許可證文件和第三方許可證列表，網址為：wire.com/legal/licenses/。

If you compile the open source software that we make available from time to time to develop your own mobile, desktop or web application, and cause that application to connect to our servers for any purposes, we refer to that resulting application as an “Open Source應用程式".所有開源應用程式均受適用於Wire 應用程式的使用條款的約束，並且只能根據適用於Wire 應用程式的使用條款進行使用和/或商業化，該使用條款可在https://wire.com/ legal/#terms 上找到。此外，如果您選擇建立開源應用程序，則存在某些限制，如下所示：

一個。您同意不改變開源應用程式與我們的伺服器連接和互動的方式； b.您同意不削弱開源應用程式的任何安全功能； c.您同意不使用我們的伺服器儲存資料用於開源應用程式的預期和原始功能之外的目的； d.您承認您對您的開源應用程式的任何及所有更新承擔全部責任。

為清楚起見，如果您編譯我們不時提供的開源軟體來開發您自己的移動、桌面或 Web 應用程序，並且不導致該應用程式出於任何目的連接到我們的伺服器，則該應用程式將不會被被視為開源應用程序，上述規定不適用於該應用程式。

Wire 商標及其相關標誌未獲得任何許可，所有這些商標及其相關標誌將繼續由 Wire Swiss GmbH 獨家擁有。未經 Wire Swiss GmbH 事先明確書面同意，明確禁止使用 Wire 商標和/或其相關標誌。

有線安卓

開源客戶端包含什麼

此儲存庫中的項目包含適用於 Android 用戶端專案的 Wire。您可以自己建立該專案。但是，與 Play 商店中提供的二進位 Wire 用戶端存在一些差異。這些差異是：

• 此開源專案不包含第三方服務的 API 金鑰。
• 此開源專案連結到開源 Wire 音訊視訊訊號 (AVS) 庫。二進位 Play 商店用戶端連結到 AVS 版本，該版本包含針對通話品質的專有改進。

所需軟體

為了在本地建置適用於 Android 的 Wire，需要安裝以下工具：

• JDK 17
• 安卓軟體開發工具包
• 安卓NDK

搖籃

這些是透過命令列可用的gradle任務：

• ./gradlew compileApp : 編譯 Wire Android 用戶端
• ./gradlew assembleApp ：組裝 Wire Android 用戶端
• ./gradlew runApp ：在連接的裝置中組裝並執行 Wire Android 用戶端。
• ./gradlew runUnitTests ：執行所有單元測試。
• ./gradlew runAcceptanceTests ：在連接的裝置中執行所有驗收測試。
• ./gradlew testCoverage ：產生測試程式碼覆蓋率報告
• ./gradlew staticCodeAnalysis ：在 Wire Android 程式碼庫上執行靜態程式碼分析

安卓工作室

透過瀏覽到專案目錄的build.gradle.kts檔案的根路徑，將專案匯入為 gradle 專案。

典型的建置問題

克隆 Android 專案後，您的 IDE（IntelliJ 或 Android studio）上可能會出現一些建置問題。為了避免大多數這些情況，請確保：

• 複製 Android 專案後，您已執行git submodule update --init --recursive （以初始化嵌入式 Kalium 子模組專案中的任何所需配置）
• local.properties和kalium/local.properties檔案上有一個有效的 SDK 路徑，指向 Android SDK 資料夾。在 Mac 中，該資料夾通常可以在sdk.dir=/Users/YOUR_USER_FOLDER/Library/Android/sdk下找到。 IDE不會自動建立kalium/local.properties ，因此您可能需要將其複製/貼上到專案根目錄中
• 當您已經開始在專案上添加一些提交時，您的本地建置可能會中斷，如果是這種情況，請確保您已透過執行以下命令更新了kalium子模組引用： git submodule update --remote --merge

應用程式風格

我們有幾種不同的應用程式風格，具有不同的預期用途。每個應用程式風格都有不同的圖示背景顏色，以便於區分。要了解它們的詳細定制方式，請檢查風味配置文件。

筆記

對於自訂構建，我們會覆蓋一些標誌、字串和圖示。檢查 CUSTOMIZATION.md 以了解詳細資訊。

姓名	圖示背景顏色	描述/預期用途	啟用日誌記錄	預設後端
開發者	？	用於開發新功能。血淋淋的邊緣。不穩定。暫存後端。早餐吃實驗性功能，甜點喝開發人員的眼淚。	✅	電線分級
分期	？	主要用於 QA 測試具有暫存後端的類似發布的應用程式。模仿生產/發布應用程序，具有以下 Prod/White 應用程式之後的功能標誌，但具有額外的開發工具。	✅	電線分級
內部的	？	目前未使用（？）。它過去曾被使用過，可能很快就會被刪除。	✅	線材產品
貝塔	？	被公司內部使用者用作dogfood。一些尚未為公眾準備好的功能可能會首先在這裡進行測試。	✅	線材產品
產品	⚪	該生產應用程式可供公眾使用。	✖️	線材產品
F-機器人	⚪	也是一個可供公眾使用的生產應用程式。發佈在 F-Droid 商店，但沒有任何閉源軟體。	✖️	線材產品

記錄

重要的

除 Prod 和 F-Droid 之外的所有版本的日誌都將上傳到第三方服務以供開發人員分析。

Prod 和 F-Droid 上的日誌可以在應用程式中啟用，但不會上傳到任何地方。用戶可以從應用程式手動匯出和讀取日誌檔案。

我們不會以任何方式記錄敏感內容（例如訊息內容、加密金鑰等）。諸如唯一標識符之類的東西被混淆了。

建置類型

可以建立應用程式以進行發布或調試。調試版本可能有額外的調試工具，不會縮小，並且可以根據需要進行分析。一般來說，由於缺乏最小化，調試建置運行速度較慢。

貢獻

如果您想為 Android 版 Wire 做出貢獻，請參閱 CONTRIBUTING.md 檔案以取得更多資訊。