wire webapp

線材™

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

您可以在 github.com/wireapp/wire 找到已發佈的原始程式碼。

有關許可信息，請參閱所附的許可證文件和第三方許可證列表，網址為：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 商標和/或其相關標誌。

如何建立開源客戶端

先決條件：

1. 安裝 Node.js
2. 安裝紗線

1. 取得依賴和配置

1. 跑yarn

   • 這將安裝所有依賴項並獲取應用程式的配置。

2. 建置並運行

發展

1. 將.env.localhost重新命名為.env以設定應用程式。此配置可以覆蓋/擴充上一步的配置。
2. 將下列項目新增至您的主機檔案（macOS / Linux： /etc/hosts ，Windows 10： %WINDIR%system32driversetchosts ）：
   • 127.0.0.1 local.wire.com （與生產後端連接）
   • 127.0.0.1 local.zinfra.io （與暫存後端連接）
3. 運行yarn start ，Wire的網路應用程式將在以下位置可用：https://local.zinfra.io:8081/auth/

安裝自簽名憑證

如果您希望瀏覽器信任來自「local.wire.com」或「local.zinfra.io」的憑證：

1. 下載mkcert
2. 將CAROOT環境變數設定為<WebApp Dir>/server/certificate
3. 運行mkcert -install

生產

1. 運行yarn build:prod
2. 執行cd server && yarn start:prod

測試

要啟動完整的測試套件（類型檢查 + linting + 伺服器測試 + 應用程式測試），只需執行：

yarn test

或者，您可以測試應用程式的特定部分：

yarn test:(server|types|app)

CI狀態

翻譯

所有 Wire 翻譯均透過 Crowdin 眾包。

新增字串

資訊:

• 要下載翻譯，我們使用 Crowdin API v1，您需要設定您的使用者名稱和 api_key（帳戶 API 金鑰）。
• 要上傳翻譯，我們使用 Crowdin CLI v3，您需要設定 project_identifier 和 api_token（個人存取權杖）。

設定:

在此儲存庫中建立一個keys/crowdin.yaml並新增以下項目：

 api_key : your-account-api-key
api_token : your-personal-access-token
project_identifier : wire-webapp
username : your-username

用法：

1. 將字串變數加入到“i18n/en-US.json”
2. 建立 PR 並在批准後合併。當 PR 合併後，我們的 CI 將負責將英文文字上傳到 Crowdin。

如果我們的 CI 管道損壞，您仍然可以選擇手動上傳新字串。對於這種情況，請執行以下操作：

1. 安裝 Crowdin CLI v3
2. 驗證您是否已準備好keys/crowdin.yaml
3. 運行yarn translate:upload

將翻譯上傳到 Crowdin 後，我們（和外部）翻譯人員就可以在 Crowdin 上翻譯新字串。有一個腳本將運行來創建帶有翻譯更新的 PR。作為替代方案，可以透過以下方式下載翻譯：

1. 驗證您的字串是否顯示在 Crowdin 專案上：wire-webapp
2. 在 Crowdin 上加入翻譯
3. 在 Crowdin 上批准翻譯
4. 運行yarn translate:download

貢獻

歡迎貢獻！請隨時查看我們的問題頁面。

以下提交將幫助您快速開始使用我們的程式碼庫：

• 顯示模式/彈出視窗
• 透過後端之間的同步設定