{"id":13632114,"url":"https://github.com/immuni-app/immuni-app-ios","last_synced_at":"2025-04-18T02:32:04.233Z","repository":{"id":38030546,"uuid":"264475019","full_name":"immuni-app/immuni-app-ios","owner":"immuni-app","description":"Official repository for the iOS version of the immuni application","archived":true,"fork":false,"pushed_at":"2022-12-28T15:18:20.000Z","size":14551,"stargazers_count":544,"open_issues_count":0,"forks_count":89,"subscribers_count":24,"default_branch":"development","last_synced_at":"2024-12-29T16:32:58.742Z","etag":null,"topics":["covid19","ios","mobile","mobile-app","swift"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/immuni-app.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null}},"created_at":"2020-05-16T16:09:15.000Z","updated_at":"2024-12-24T05:38:00.000Z","dependencies_parsed_at":"2023-01-31T06:46:09.129Z","dependency_job_id":null,"html_url":"https://github.com/immuni-app/immuni-app-ios","commit_stats":null,"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immuni-app%2Fimmuni-app-ios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immuni-app%2Fimmuni-app-ios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immuni-app%2Fimmuni-app-ios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immuni-app%2Fimmuni-app-ios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/immuni-app","download_url":"https://codeload.github.com/immuni-app/immuni-app-ios/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249414253,"owners_count":21267724,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["covid19","ios","mobile","mobile-app","swift"],"created_at":"2024-08-01T22:02:52.282Z","updated_at":"2025-04-18T02:31:59.223Z","avatar_url":"https://github.com/immuni-app.png","language":"Swift","funding_links":[],"categories":["Health","Swift"],"sub_categories":["Contact Tracing"],"readme":"\u003ch1 align=\"center\"\u003eImmuni iOS\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"256\" height=\"256\" src=\".github/logo.png\"\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003c!-- Latest Release --\u003e\n    \u003ca href=\"https://github.com/immuni-app/immuni-app-ios/releases\"\u003e\n      \u003cimg alt=\"GitHub release (latest SemVer)\"\n      src=\"https://img.shields.io/github/v/release/immuni-app/immuni-app-ios\"\u003e\n    \u003c/a\u003e\n    \u003c!-- CoC --\u003e\n    \u003ca href=\"CODE_OF_CONDUCT.md\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://circleci.com/gh/immuni-app/immuni-app-ios\"\u003e\n      \u003cimg alt=\"Circle CI Status\"\n      src=\"https://circleci.com/gh/immuni-app/immuni-app-ios.svg?style=svg\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch3\u003e\n    \u003c/span\u003e\n    \u003ca href=\"https://github.com/immuni-app/immuni-documentation\"\u003e\n      Documentation\n    \u003c/a\u003e\n    \u003cspan\u003e | \u003c/span\u003e    \n    \u003ca href=\"CONTRIBUTING.md\"\u003e\n      Contributing\n    \u003c/a\u003e\n  \u003c/h3\u003e\n\u003c/div\u003e\n\n# Table of contents\n\n- [Context](#context)\n- [Installation](#installation)\n  - [Backend services](#backend-services)\n- [UI testing](#ui-testing)\n- [Checking the build](#checking-the-build)\n- [Contributing](#contributing)\n  - [Contributors](#contributors)\n- [License](#license)\n  - [Authors / Copyright](#authors--copyright)\n  - [Third-party component licenses](#third-party-component-licenses)\n    - [Tools](#tools)\n    - [Libraries](#libraries)\n  - [License details](#license-details)\n\n# Context\n\nThis repository contains the source code of Immuni's iOS client. More detailed information about Immuni can be found in the following documents:\n\n- [High-Level Description](https://github.com/immuni-app/immuni-documentation)\n- [Product Description](https://github.com/immuni-app/immuni-documentation/blob/master/Product.md)\n- [Technology Description](https://github.com/immuni-app/immuni-documentation/blob/master/Technology.md)\n- [Traffic Analysis Mitigation](https://github.com/immuni-app/immuni-documentation/blob/master/Traffic%20Analysis%20Mitigation.md)\n\n**Please take the time to read and consider these documents in full before digging into the source code or opening an Issue. They contain a lot of details that are fundamental to understanding the source code and this repository's documentation.**\n\n# Installation\n\nThe recommended method requires that [Xcode 11.5](https://developer.apple.com/xcode/) and [Brew](https://brew.sh/) are installed on your Mac. If you would prefer to follow a custom method, you have the option not to install Brew. Please refer to the [Makefile](Makefile) to check which dependencies are needed; you may install those manually instead.\n\n```sh\ngit clone https://github.com/immuni-app/immuni-app-ios.git\ncd immuni-app-ios\n\n# This command will install the environment needed to run the project using Brew.\n# If you prefer to install them manually, check the Makefile.\n# Note: this step should be done just once\nmake setup\nmake immuni\n```\n\nPlease note the following:\n\n- The project may be built and run in the simulator.\n- If you wish to install the application on a real device, you will need to join the [Apple Developer Program](https://developer.apple.com/programs/) and sign the App with your certificate.\n- Apple requires a [special entitlement](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_developer_exposure-notification) to make the [Exposure Notification](https://developer.apple.com/documentation/exposurenotification) system work. To obtain this entitlement, you must be either a government entity or a developer approved by a government entity to develop an application on behalf of a government for COVID-19 response efforts. This is stated in the [APIs addendum](https://developer.apple.com/contact/request/download/Exposure_Notification_Addendum.pdf). You should remove _Exposure Notification_ entitlements from the entitlements file before compiling the application. You may build and use the application, but you will not be able to use the underlying Exposure Notification system.\n\nFor more information about how the project is generated and structured, please refer to the [CONTRIBUTING](CONTRIBUTING.md) file.\n\n# UI testing\n\nThe repository contains a system that can generate snapshots of the application's UI in different contexts (e.g., in various languages). This is a good way of checking the UI's issues and having an overview of the various UI states. To generate them, set up the project and run `make run_uitests`. The generated screenshots are located in the `UITests/Screenshots` folder.\n\nPlease be aware that this process may take some time, depending on your computer's hardware.\n\n# Checking the build\n\nIn addition to making the code open-source, we wish to help people verify that builds published on the App Store are coming from a specific commit of this repository. Please refer to the [Immuni Technology Description](https://github.com/immuni-app/immuni-documentation/blob/master/Technology.md#ios-app-technologies) for a complete overview of the goals and status of this effort.\n\nCurrently, we have a working open continuous integration for building the client. [Here](.circleci/config.yml) is the full specification. When it comes to reproducible builds, we will instead open an issue explaining what we have done so far and any missing steps.\n\n# Contributing\n\nContributions are most welcome. Before proceeding, please read the [Code of Conduct](CODE_OF_CONDUCT.md) for guidance on how to approach the community and create a positive environment. Additionally, please read our [CONTRIBUTING](CONTRIBUTING.md) file, which contains guidance on ensuring a smooth contribution process.\n\nThe Immuni project is composed of different repositories—one for each component or service. Please use this repository for contributions strictly relevant to the Immuni iOS client. To propose a feature request, please open an issue in the [Documentation repository](https://github.com/immuni-app/immuni-documentation). This lets everyone involved see it, consider it, and participate in the discussion. Opening an issue or pull request in this repository may slow down the overall process.\n\n## Contributors\n\nHere is a list of Immuni's contributors. Thank you to everyone involved for improving Immuni, day by day.\n\n\u003ca href=\"https://github.com/immuni-app/immuni-app-ios/graphs/contributors\"\u003e\n  \u003cimg\n  src=\"https://contributors-img.web.app/image?repo=immuni-app/app-ios\"\n  /\u003e\n\u003c/a\u003e\n\n# License\n\n## Authors / Copyright\n\nCopyright 2020 (c) Presidenza del Consiglio dei Ministri.\n\nPlease check the [AUTHORS](AUTHORS) file for extended reference.\n\n## Third-party component licenses\n\n### Tools\n\n| Name                                                        | License                   |\n| ----------------------------------------------------------- | ------------------------- |\n| [Brew](https://brew.sh/)                                    | BSD 2-Clause 'Simplified' |\n| [Cocoapods](https://cocoapods.org/)                         | MIT                       |\n| [CommitLint](https://commitlint.js.org/#/)                  | MIT                       |\n| [Danger](https://danger.systems/js/)                        | MIT                       |\n| [SwiftFormat](https://github.com/nicklockwood/SwiftFormat/) | MIT                       |\n| [SwiftGen](https://github.com/SwiftGen/SwiftGen)            | MIT                       |\n| [SwiftLint](https://github.com/realm/SwiftLint)             | MIT                       |\n| [XcodeGen](https://github.com/yonaskolb/XcodeGen)           | MIT                       |\n\n### Libraries\n\n| Name                                                       | License    |\n| ---------------------------------------------------------- | ---------- |\n| [Katana](https://github.com/BendingSpoons/katana-swift)    | MIT        |\n| [Tempura](https://github.com/BendingSpoons/tempura-swift/) | MIT        |\n| [Alamofire](https://github.com/Alamofire/Alamofire)        | MIT        |\n| [BonMot](https://github.com/Rightpoint/BonMot)             | MIT        |\n| [Hydra](https://github.com/malcommac/Hydra/)               | MIT        |\n| [Lottie](https://github.com/airbnb/lottie-ios)             | Apache 2.0 |\n| [PinLayout](https://github.com/layoutBox/PinLayout)        | MIT        |\n| [SwiftLog](https://github.com/apple/swift-log/)            | Apache 2.0 |\n| [ZIPFoundation](https://github.com/weichsel/ZIPFoundation) | MIT        |\n\n## License details\n\nThe licence for this repository is a [GNU Affero General Public Licence version 3](https://www.gnu.org/licenses/agpl-3.0.html) (SPDX: AGPL-3.0). Please see the [LICENSE](LICENSE) file for full reference.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimmuni-app%2Fimmuni-app-ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimmuni-app%2Fimmuni-app-ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimmuni-app%2Fimmuni-app-ios/lists"}