Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/deltachat/deltachat-ios

Email-based instant messaging for iOS.
https://github.com/deltachat/deltachat-ios

deltachat email ios messenger

Last synced: about 6 hours ago
JSON representation

Email-based instant messaging for iOS.

Host: GitHub
URL: https://github.com/deltachat/deltachat-ios
Owner: deltachat
License: other
Created: 2017-11-06T09:27:18.000Z (about 7 years ago)
Default Branch: main
Last Pushed: 2024-10-29T11:44:34.000Z (3 months ago)
Last Synced: 2024-10-29T13:10:07.594Z (3 months ago)
Topics: deltachat, email, ios, messenger
Language: Swift
Homepage:
Size: 167 MB
Stars: 320
Watchers: 20
Forks: 51
Open Issues: 13
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

fucking-open-source-ios-apps - deltachat - based instant messaging (Communication)

README

# Delta Chat iOS Client

This is the iOS client for [Delta Chat](https://delta.chat/).
It is available on [Testflight](#testing)
and in the [App Store](https://apps.apple.com/us/app/delta-chat/id1459523234).

For the core library and other common info, please refer to the
[Delta Chat Core Library](https://github.com/deltachat/deltachat-core-rust).

For general contribution hints, please refer to [CONTRIBUTING.md](./CONTRIBUTING.md).

![Screenshot Chat List](docs/images/screenshot_chat_list.png) ![Screenshot Chat View](docs/images/screenshot_chat_view.png)

## Testing

Betas are distributed via Testflight. Just scan this QR code with the camera app of your iPhone/iPad

or open this link

https://testflight.apple.com/join/uEMc1NxS

on your iPhone or iPad to try Deltachat iOS Beta.

Check the Changelog (for TestFlight builds) at the bottom to see what's included.

## How to build with Xcode

### Install [rustup](https://rustup.rs)

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

### Install [cargo-lipo](https://github.com/TimNN/cargo-lipo#installation)

```bash
cargo install cargo-lipo
```

### Setup workspace

```bash
git clone [email protected]:deltachat/deltachat-ios.git
cd deltachat-ios
git submodule update --init --recursive
# Make sure the correct rust version is installed
rustup toolchain install `cat rust-toolchain`
```

To run the project, open `deltachat-ios.xcworkspace` (**not** the 'xcodeproj' file).

```bash
open deltachat-ios.xcworkspace
```

This should open Xcode. Then make sure to select the *deltachat-ios* scheme at the top left (see screenshot below).

![Screenshot](docs/images/screenshot_scheme_selection.png)

Now build and run - e.g. by pressing Cmd-r - or click on the triangle at the top:

![Screenshot](docs/images/screenshot_build_and_run.png)

If you're on MacOS Mojave and Xcode complains about missing header files (different mac versions may or may not install all headers),
you can force-install them with the following command:

```bash
$ sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /
```

If you get an error about that file not existing, you probably simply don't have the Xcode command line tools installed which can be remedied simply as follows:

```bash
$ xcode-select --install
```

On MacOS Catalina the include paths changed, `/usr/include` doesn't exist anymore.
You'll need to manually set the `CPATH` variable to specify the location of the header files:

```
export CPATH=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include
```
Note: the default terminal switched to zsh on MacOS Catalina. All your exported variables have to move to ~/.zshrc

## Running the app on M1 Mac computers

If you want to import/export a backup this is the location you want to put it (import) or retrieve it (export)
```
~/Library/Containers/98CC2CD0-7DED-4E02-9C0A-B4FF287AA877/Data/Documents
```

# LICENSE