57 lines
3.8 KiB
Markdown
57 lines
3.8 KiB
Markdown
[](https://matrix.to/#/#element-x-ios:matrix.org)
|
|
|
|
|
|
|
|
|
|
|
|
[](https://codecov.io/gh/element-hq/element-x-ios)
|
|
[](https://sonarcloud.io/summary/new_code?id=vector-im_element-x-ios)
|
|
[](https://sonarcloud.io/summary/new_code?id=vector-im_element-x-ios)
|
|
[](https://sonarcloud.io/summary/new_code?id=vector-im_element-x-ios)
|
|
|
|
# Element X iOS
|
|
|
|
ElementX iOS is a [Matrix](https://matrix.org/) iOS Client provided by [Element](https://element.io/).
|
|
|
|
The application is a total rewrite of [Element-iOS](https://github.com/element-hq/element-ios) using the [Matrix Rust SDK](https://github.com/matrix-org/matrix-rust-sdk) underneath and targetting devices running iOS 16+.
|
|
|
|
## Rust SDK
|
|
|
|
ElementX leverages the [Matrix Rust SDK](https://github.com/matrix-org/matrix-rust-sdk) through an FFI layer exposed as a [swift package](https://github.com/matrix-org/matrix-rust-components-swift) that the final client can directly import and use.
|
|
|
|
We're doing this as a way to share code between platforms and while we've seen promising results it's still in the experimental stage and bound to change.
|
|
|
|
## Status
|
|
|
|
This project is in work in progress. The app does not cover yet all functionalities we expect.
|
|
|
|
## Contributing
|
|
|
|
Please see our [contribution guide](CONTRIBUTING.md).
|
|
|
|
Come chat with the community in the dedicated Matrix [room](https://matrix.to/#/#element-x-ios:matrix.org).
|
|
|
|
## Build instructions
|
|
|
|
Please refer to the [setting up a development environment](CONTRIBUTING.md#setting-up-a-development-environment) section from the [contribution guide](CONTRIBUTING.md).
|
|
|
|
## Support
|
|
|
|
When you are experiencing an issue on ElementX iOS, please first search in [GitHub issues](https://github.com/element-hq/element-x-ios/issues)
|
|
and then in [#element-x-ios:matrix.org](https://matrix.to/#/#element-x-ios:matrix.org).
|
|
If after your research you still have a question, ask at [#element-x-ios:matrix.org](https://matrix.to/#/#element-x-ios:matrix.org). Otherwise feel free to create a GitHub issue if you encounter a bug or a crash, by explaining clearly in detail what happened. You can also perform bug reporting (Rageshake) from the Element application by shaking your phone or going to the application settings. This is especially recommended when you encounter a crash.
|
|
|
|
## Forking
|
|
|
|
Please read our [forking guide](docs/FORKING.md).
|
|
|
|
## Copyright & License
|
|
|
|
Copyright (c) 2022 New Vector Ltd
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the [LICENSE](LICENSE) file, or at:
|
|
|
|
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
|
|
|
|
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
|