CountryPicker

CountryPicker 是一个 Swift 库，提供了一个简单易用的界面，用于从预定义列表中选择国家。它非常适合以最小的努力为你的 iOS 应用程序添加国家选择功能。

• 通过搜索和章节索引标题导航，例如 (在 iOS 的联系人应用中)
• 自动滚动到上次选择的国家
• 国家选项过滤
• 样式视图选项
• 图片大小已优化
• 集成 Cocoa Pods
• 集成 Carthage
• 集成 Swift package manager
• 遵循最佳实践
• 支持深色模式
• 支持 ContentSizeCategory 的动态字体大小
• 单元测试覆盖率 94%
• 添加了带有自定义的 Picker view 支持
• Swift UI 支持，带有示例项目
• 在 3.0.0 版本中使用 swiftUI 和 combine 重写

• iOS 15.0+ 支持最新版本 iOS 17，对于 3.0.0 之前的旧版本，支持更旧的用户
• 最新的 Xcode 15.x 和 Swift

要运行示例项目，请克隆 repo，并首先从 Example 目录运行 pod update。

|

主页场景	国家选择器场景	过滤场景	深色模式场景	Picker View

CountryPicker 可通过 Cocoapods 和 Carthage 获得。

将以下行添加到你的 Podfile

For iOS 15 and above (Combine and Swiftui version) currently only supported by cocoapods 
pod 'SKCountryPicker'

请注意，iOS 15 将在 2024 年后停止支持。

使用 Carthage 进行依赖管理的步骤在此处描述 here，但为了方便，也将其添加到此 README 中。

首先，你需要将以下行添加到你的 Cartfile

github "SURYAKANTSHARMA/CountryPicker"

以包含最新版本的 CountryPicker。

（如果你没有 Cartfile，你需要先在你喜欢的文本编辑器中创建一个）

接下来运行

carthage update --platform iOS

这将使 Carthage

• 从 Github 获取 CountryPicker 的源代码
• 将源代码编译成框架供你使用

Carthage 完成构建后，你需要将框架添加到你的项目中。

在 Xcode 中

• 导航到你项目的“General”选项卡，然后点击“Frameworks, Libraries and Embedded Content”下的加号。
• 选择“Add other”并找到 Carthage 文件夹（通常在你项目的根目录中）
• SKCountryPicker.framework 位于 Carthage/Build/iOS/ 下
• 选择它并验证它是否已添加为框架。

最后一步是将 copy-frameworks 构建脚本添加到你的“Build Phases”。

• 导航到“Build Phases”并点击顶部的 + 号。
• 选择“New Run Script Phase”
• 粘贴此行作为要运行的脚本 /usr/local/bin/carthage copy-frameworks
• 在 Input Files 下添加 SKCountryPicker.framework，如下所示：$(SRCROOT)/Carthage/Build/iOS/SKCountryPicker.framework

完成！

将以下行添加到你的 Package.swift 文件中的 dependencies 部分

.package(url: "https://github.com/SURYAKANTSHARMA/CountryPicker.git, from "4.0.0")

请查看 baseiOS11Example 项目，了解自定义以及与旧版 uikit 一起使用的不同选项。

请查看 baseiOS15Example 项目，了解如何在最低部署目标为 iOS 15 的 swift ui 应用程序中使用它

有 3 个主要筛选选项 countryName、countryCode、countryDialCode，默认情况下，国家选择器已配置为基于 countryName 筛选国家。

如果你想添加/删除筛选选项，请按如下操作

 // Adding filter
 CountryManager.shared.addFilter(.countryCode)

 // Removing filter
 CountryManager.shared.removeFilter(.countryCode)

 // Removing all filters
 CountryManager.shared.clearAllFilters()

如果你想检索 country 信息

// Get country based on digit code e.g: 60, +255
CountryManager.shared.country(withDigitCode: "255")

// Get country based on country name
CountryManager.shared.country(withName: "Tanzania")

// Get country based on country code e.g: MY, TZ
CountryManager.shared.country(withCode: "MY")

• 使用 3.0.0 及以上版本

欢迎任何使项目变得更好的贡献。

*Suryakant Sharma

另请参阅参与此项目的 贡献者 列表。衷心感谢 Hardeep Singh 给予的灵感

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件