Этот репозиторий является частью исходного кода Wire. Дополнительную информацию можно найти на сайте Wire.com или по адресу [email protected].
Опубликованный исходный код можно найти по адресу github.com/wireapp/wire, а APK-файл последней версии — по адресу https://wire.com/en/download/.
Информацию о лицензировании см. в прикрепленном файле ЛИЦЕНЗИИ и списке лицензий третьих сторон на сайте Wire.com/legal/licenses/.
Если вы скомпилируете программное обеспечение с открытым исходным кодом, которое мы время от времени предоставляем, для разработки собственного мобильного, настольного или веб-приложения и заставите это приложение подключаться к нашим серверам для каких-либо целей, мы будем называть такое полученное приложение «открытым исходным кодом». Приложение". На все приложения с открытым исходным кодом распространяются и могут использоваться и/или коммерциализироваться только в соответствии с Условиями использования, применимыми к приложению Wire, которые можно найти по адресу https://wire.com/legal/#terms. Кроме того, если вы решите создать приложение с открытым исходным кодом, применяются определенные ограничения, а именно:
а. Вы соглашаетесь не изменять способ подключения и взаимодействия Приложения с открытым исходным кодом с нашими серверами; б. Вы соглашаетесь не ослаблять какие-либо функции безопасности Приложения с открытым исходным кодом; в. Вы соглашаетесь не использовать наши серверы для хранения данных в целях, отличных от предполагаемых и первоначальных функций Приложения с открытым исходным кодом; д. Вы признаете, что несете единоличную ответственность за все обновления вашего Приложения с открытым исходным кодом.
Для ясности: если вы скомпилируете программное обеспечение с открытым исходным кодом, которое мы время от времени предоставляем, для разработки вашего собственного мобильного, настольного или веб-приложения и не заставите это приложение подключаться к нашим серверам для каких-либо целей, то это приложение не будет считается приложением с открытым исходным кодом, и вышеизложенное не применимо к этому приложению.
Никакая лицензия не предоставляется на товарный знак Wire и связанные с ним логотипы, которые по-прежнему будут принадлежать исключительно Wire Swiss GmbH. Любое использование товарного знака Wire и/или связанных с ним логотипов категорически запрещено без предварительного письменного согласия Wire Swiss GmbH.
Проект в этом репозитории содержит клиентский проект Wire для Android. Вы можете построить проект самостоятельно. Однако есть некоторые различия с бинарным клиентом Wire, доступным в Play Store. Эти различия заключаются в следующем:
Чтобы собрать Wire для Android локально, необходимо установить следующие инструменты:
Это доступные задачи gradle
через командную строку:
./gradlew compileApp
: компилирует клиент Wire для Android../gradlew assembleApp
: собирает клиент Wire для Android../gradlew runApp
: собирает и запускает клиент Wire Android на подключенном устройстве../gradlew runUnitTests
: запускает все модульные тесты../gradlew runAcceptanceTests
: запускает все приемочные тесты на подключенном устройстве../gradlew testCoverage
: генерирует отчет о покрытии тестового кода../gradlew staticCodeAnalysis
: запускает статический анализ кода в базе кода Wire Android. Импортируйте проект как проект gradle, перейдя к корневому пути файла build.gradle.kts
в каталоге вашего проекта.
Возможно, после клонирования проекта Android в вашей IDE (IntelliJ или студия 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.
Имя | Цвет фона значка | Описание/Предполагаемое использование | Ведение журнала включено | Серверная часть по умолчанию |
---|---|---|---|---|
Дев | ? | Для разработки новых функций. Кровоточащий край. Нестабильный. Промежуточный бэкэнд. Ест экспериментальные функции на завтрак и пьет слезы разработчиков на десерт. | ✅ | Проволочная постановка |
Постановка | ? | В основном для контроля качества для тестирования приложения, похожего на релиз, с промежуточным бэкэндом. Имитирует приложение Production/Release, имея флаги функций, следующие за приложением Prod/White ниже, но с дополнительными инструментами разработки. | ✅ | Проволочная постановка |
Внутренний | ? | В настоящее время не используется (?). Он использовался в прошлом и, вероятно, должен быть удален в ближайшее время. | ✅ | Проволока |
Бета | ? | Используется внутренними пользователями внутри компании в качестве тестовой версии. Некоторые функции, которые еще не готовы для широкой публики, можно сначала протестировать здесь. | ✅ | Проволока |
Прод | ⚪ | Производственное приложение доступно для широкой публики. | ✖️ | Проволока |
F-дроид | ⚪ | Также производственное приложение доступно для широкой публики. Опубликовано в магазине F-Droid, но без какого-либо программного обеспечения с закрытым исходным кодом. | ✖️ | Проволока |
Важный
Журналы всех сборок, кроме Prod и F-Droid, будут загружены в сторонний сервис для анализа разработчиками.
Логи на Prod и F-Droid можно включить внутри приложения, но они никуда НЕ загружаются. Пользователи могут экспортировать и читать файлы журналов вручную из приложения.
Мы никоим образом не регистрируем конфиденциальный контент (например, содержимое сообщений, ключи шифрования и т. д.). А такие вещи, как уникальные идентификаторы, запутаны.
Приложения можно создавать для выпуска или отладки. Отладочные версии могут иметь дополнительные инструменты отладки, не минимизироваться и при необходимости могут быть профилированы. В целом отладочные сборки выполняются медленнее из-за отсутствия минимизации.
Если вы хотите внести свой вклад в Wire для Android, обратитесь к файлу CONTRIBUTING.md для получения дополнительной информации.