wireapp/wire-ios


📱 Wire for iOS (iPhone and iPad)

https://wire.com/download/

License: GPL-3.0

Language: Swift

Keywords: app, audio, communication, encryption, end-to-end, instant-messaging, ios, messenger, messenger-platform, mobile, mobile-app, otr, privacy, security, swift, swift5, video, wire, wire-ios


Wire™

Wire logo

Build Status

This repository is part of the source code of Wire. You can find more information at wire.com or by contacting opensource@wire.com.

You can find the published source code at github.com/wireapp/wire.

For licensing information, see the attached LICENSE file and the list of third-party licenses at 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 App”. All Open Source Apps are subject to, and may only be used and/or commercialized in accordance with, the Terms of Use applicable to the Wire Application, which can be found at https://wire.com/legal/#terms. Additionally, if you choose to build an Open Source App, certain restrictions apply, as follows:

a. You agree not to change the way the Open Source App connects and interacts with our servers; b. You agree not to weaken any of the security features of the Open Source App; c. You agree not to use our servers to store data for purposes other than the intended and original functionality of the Open Source App; d. You acknowledge that you are solely responsible for any and all updates to your Open Source App.

For clarity, 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 do not cause that application to connect to our servers for any purposes, then that application will not be deemed an Open Source App and the foregoing will not apply to that application.

No license is granted to the Wire trademark and its associated logos, all of which will continue to be owned exclusively by Wire Swiss GmbH. Any use of the Wire trademark and/or its associated logos is expressly prohibited without the express prior written consent of Wire Swiss GmbH.

Wire iOS

The Wire mobile app has an architectural layer that we call sync engine . It is the client-side layer that processes all the data that is displayed in the mobile app. It handles network communication and authentication with the backend, push notifications, local caching of data, client-side business logic, signaling with the audio-video libraries, encryption and decryption (using encryption libraries from a lower level) and other bits and pieces.

The user interface layer of the mobile app is built on top of the sync engine, which provides the data to display to the UI. The sync engine itself is built on top of a few third-party frameworks, and uses Wire components that are shared between platforms for cryptography (Proteus/Cryptobox) and audio-video signaling (AVS).

Mobile app architecture

The iOS application follows closely the overall mobile architecture, adding its layers of iOS and UI helpers.

iOS app architecture

wire-ios-sync-engine is the top-most layer of the iOS sync engine, and it is using a number of other frameworks itself.

Repositories

  • wire-ios-sync-engine: topmost layer that implements client-side business logic, caching, encryption and client-side backend communication protocol

How to build the open source client

What is included in the open source client

The project in this repository contains the Wire iOS client project. You can build the project yourself. However, there are some differences with the binary Wire iOS client available on the App Store. These differences are:

  • the open source project does not include the API keys of Vimeo, Localytics, HockeyApp and other 3rd party services.
  • the open source project links against the open source Wire audio-video-signaling (AVS) library. The binary App Store client links against an AVS version that contains proprietary improvements for the call quality.

Prerequisites

In order to build Wire for iOS locally, it is necessary to install the following tools on the local machine:

The setup script will automatically check for you that you satisfy these requirements

How to build locally

  1. Check out the wire-ios repository.
  2. From the checkout folder, run ./setup.sh. This will pull in all the necessary dependencies with Carthage and CocoaPods and verify that you have the right version of the tools installed. If you did not have CocoaPods version >= 1.0.0 installed before this script will fail and you will need to run bundle exec pod repo update manually before running it again.
  3. Open the workspace Wire-iOS.xcworkspace in Xcode
  4. Click the "Run" button in Xcode

These steps allow you to build only the Wire umbrella project, pulling in all other Wire frameworks with Carthage. If you want to modify the source/debug other Wire frameworks, you can open the Carthage/Checkouts subfolder and open the individual projects for each dependency there.

You can then use carthage build --platform ios to rebuild the dependency and use it in the umbrella project.

Known limitations

Notifications send through Apple Push Notification service can only be received by the App Store Wire client, which is code signed with Wire's own certificate. This is a security feature enforced by Apple, as documented in Apple's Local and Remote Notification Programming Guide. Any client build from source will not be able to receive notifications.

Project Statistics

Sourcerank 8
Repository Size 428 MB
Stars 2,787
Forks 477
Watchers 110
Open issues 156
Dependencies 117
Contributors 17
Tags 43
Created
Last updated
Last pushed

Top Contributors See all

Silvan Daehn Mike Gerasimenko Marco Jens Kasemets Jacob Persson Roger Sheen Sabine Geithner Florian MOREL Julian Spittka sorenskak iOS Jenkins Lipis Taniguchi Alfred Jichao Wu Chris Owen Yurii

Recent Tags See all

appstore/3.9 April 06, 2018
appstore/3.8 March 07, 2018
appstore/3.7 February 19, 2018
appstore/3.6 January 26, 2018
appstore/3.5 January 09, 2018
appstore/3.4 December 20, 2017
appstore/3.3 December 11, 2017
appstore/3.2 November 07, 2017
appstore/3.1 October 23, 2017
appstore/3.0 October 17, 2017
appstore/2.43 September 28, 2017
appstore/2.42 September 15, 2017
appstore/2.41 August 14, 2017
appstore/2.40 July 17, 2017
appstore/2.39 July 11, 2017

Interesting Forks See all

sgt39007/wire-ios
Wire iOS client (iPhone and iPad)
This repository is no longer available - 2 stars
hua597694121/wire-ios
📱 Wire iOS client (iPhone and iPad)
Objective-C - Updated - 1 stars
augmify/wire-ios
Wire iOS client (iPhone and iPad)
Objective-C - Published - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2016-12-13 14:28:59 UTC

Login to resync this repository