/dgca-app-core-ios

Repository for the iOS app core module.

Primary LanguageSwiftApache License 2.0Apache-2.0

EU Digital COVID Certificate App Core - iOS

AboutDevelopmentDocumentationSupportContributeContributorsLicensing

About

This repository contains the source code of the EU Digital COVID Certificate App Core for iOS.

The app core provides shared functionality for the verifier and wallet apps.

Translators 💬

You can help the localization of this project by making contributions to the /Localization folder.

Development

Prerequisites

  • You need a Mac to run Xcode.
  • Xcode 12.5+ is used for our builds. The OS requirement is macOS 11.0+.
  • To install development apps on physical iPhones, you need an Apple Developer account.

Build

Since this is just a requirement module, it is used as a dependency in both the verifier and wallet apps on iOS. For that, Xcode builds the module from source in the target app. Because of that, building this module on its own is not supported.

Testing 🧑‍🔬

This project uses the testdata repo for automatic tests. You can run tests in two ways:

  1. Either via ./test.sh,
  2. Or via the Xcode project project-for-testing/project-for-testing.xcodeproj.

The second option is good for debugging single test case failures. Run the test script (1.) once, so that the data repo is checked out. Then, open Xcode and run the tests. You can add automatic test failure breakpoints for easy debugging.

Documentation

Documentation

Support and feedback

The following channels are available for discussions, feedback, and support requests:

Type Channel
Issues
Other requests

How to contribute

Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.

Contributors

Our commitment to open source means that we are enabling -in fact encouraging- all interested parties to contribute and become part of its developer community.

Licensing

Copyright (C) 2021 T-Systems International GmbH and all other contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

You may obtain a copy of the License at https://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.