Diia

本仓库提供了由乌克兰数字化转型部开发的旗舰产品 Diia 的概述。

Diia 是一款可以访问公民数字文档和政府服务的应用程序。

创建这个应用程序是为了让乌克兰人能够通过几次点击就与政府互动，无需浪费时间排队和处理文书工作 - Diia 开源应用程序将帮助国家、公司和社区建立长期关系的基础。这些关系的核心是开放、高效和人性化。

我们很高兴与您分享 Diia 项目。

有用链接

主题	链接	描述
乌克兰数字化转型部	https://thedigital.gov.ua/	乌克兰数字化转型部官方主页
Diia 应用程序	https://diia.gov.ua/	Diia 应用程序官方网站

入门

安装

1.1. 克隆仓库并打开 Xcode 项目文件。

git clone https://github.com/diia-open-source/ios-diia.git
cd ios-diia
open DiiaOpenSource.xcodeproj

1.2. 等待 SPM 包解析完成。

执行程序

在 iOS 设备或模拟器上构建和运行项目。

如何测试

要获取用于测试的模拟用户，请参阅 TESTING.md 文件了解详情。

配置详情

我们使用 .xcconfig 设置文件来配置项目：

开发环境 (DiiaDev.xcconfig)

// API
API_BASE_URL = api2oss.diia.gov.ua

// 应用设置
APP_NAME = Diia OpenSource
APP_BUNDLE_ID = ua.gov.diia.opensource.app
SCHEME = DiiaDev

• API_BASE_URL：设置为后端服务器的 URL。
• APP_NAME：定义应用程序的名称。
• APP_BUNDLE_ID：指定应用程序的包标识符。
• SCHEME：指示应用程序使用的方案。

功能

授权

• 展示可用的身份验证方法
• Bank-ID 授权方法
• PIN 码。输入、更改 PIN 码，以及启用生物识别选项

文档

• 展示可用文档的集合，并能够更改顺序
• 驾驶证文档

公共服务

• 展示可用公共服务列表
• 犯罪记录摘要服务

设置菜单

它作为应用程序内个性化控制和管理的中心枢纽，提供诸如重新排序文档、更改应用程序 PIN 码、开启/关闭生物识别、联系支持、阅读应用程序和政策信息以及退出登录等功能。

依赖

几乎所有功能和核心组件（如网络核心和 UI 库）都作为独立的 SPM 包提供。

第一方

• DiiaMVPModule：模型-视图-展示者基本协议
• DiiaNetwork：基础网络层
• DiiaUIComponents：基本 UI 组件和原语
• DiiaCommonTypes：需要在多个包之间共享的类型（类、结构、协议）
• DiiaCommonServices：为 iOS 上的 Diia 提供基本支持的基础实用程序和模块
• DiiaAuthorization：授权核心、授权方法和 PIN 码
• DiiaDocuments：文档核心功能和特定文档
• DiiaPublicServices：公共服务核心功能和特定公共服务

第三方

• RNCryptor
• Lottie

如何贡献

Diia 项目欢迎对此解决方案做出贡献；请参阅 CONTRIBUTING 文件了解详情

许可

版权所有 (C) Diia 及所有其他贡献者。

根据 EUPL ("许可证") 授权；除非符合许可证，否则您不得使用此文件。根据 EUPL，允许但不鼓励重新使用，但包含不同许可证的源文件除外。

您可以在 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 获取许可证副本。

有关 Diia 项目、许可证和任何重新使用的问题应直接发送至 modt.opensource@thedigital.gov.ua。