https://github.com/surfstudio/ios-utils
Utils collection for iOS-development. Each utility is a small and frequently used piece of logic or UI component.
https://github.com/surfstudio/ios-utils
helpers ios swift tools utils
Last synced: 5 months ago
JSON representation
Utils collection for iOS-development. Each utility is a small and frequently used piece of logic or UI component.
- Host: GitHub
- URL: https://github.com/surfstudio/ios-utils
- Owner: surfstudio
- License: mit
- Created: 2018-08-08T08:49:45.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-13T14:22:40.000Z (about 1 year ago)
- Last Synced: 2025-04-15T17:02:35.691Z (6 months ago)
- Topics: helpers, ios, swift, tools, utils
- Language: Swift
- Homepage:
- Size: 21.6 MB
- Stars: 66
- Watchers: 32
- Forks: 15
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/surfstudio/iOS-Utils/actions)
[](https://codecov.io/gh/surfstudio/iOS-Utils)
[](https://cocoapods.org/pods/SurfUtils)
[](https://github.com/apple/swift-package-manager)
# iOS-Utils
Utils collection for iOS-development. Each utility is a small and frequently used piece of logic or UI component.
[](https://github.com/surfstudio/iOS-Utils)
## About
В повседневной работе часто применяются одни и те же устоявшиеся решения, участки логики. Именно они и вынесены в данную библиотеку: проверенные временем решения, охватывающие весь спектр разработки - от небольших хелперов или оберток над системными API, до полноценных UI-компонентов.
## Installation
#### CocoaPods
Для добавления всех утилит, добавьте в свой Podfile следующую строку, затем запустите `pod install`
```ruby
pod 'SurfUtils'
```
Для установки конкретной утилиты $UTIL_NAME необходимо добавить следующий код в ваш `Podfile`, затем запустить `pod install`
```ruby
pod 'SurfUtils/$UTIL_NAME$'
```
#### Swift Package Manager
- В XCode пройдите в `File > Add Packages...`
- Введите URL репозитория `https://github.com/surfstudio/iOS-Utils.git`
## Features
- Различные UI-компоненты и утилиты, завязанные на UIKit - [документация](TechDocs/uikit_utils.md)
- Хелперы, небольшие утилиты и сервисы - [документация](TechDocs/service_utils.md)
Самое полезное и наиболее часто используемое:
- [StringAttributes](TechDocs/service_utils.md#stringattributes) - упрощение работы с `NSAttributedString`
- [KeyboardPresentable](TechDocs/uikit_utils.md#keyboardpresentable) - семейство протоколов для упрощения работы с клавиатурой и сокращения количества одинакового кода
- [SkeletonView](TechDocs/uikit_utils.md#skeletonview) - cпециальная кастомная View для создания skeleton loader'ов
- [XibView](TechDocs/uikit_utils.md#xibview) - для работы UIView + xib
- [CommonButton](TechDocs/uikit_utils.md#commonbutton) - Базовый класс для кнопки
- [UIDevice](TechDocs/uikit_utils.md#uidevice) – набор вспомогательных методов для определения типа девайса
- [UIStyle](TechDocs/uikit_utils.md#uistyle) – класс для удобной работы с разными стилями UIView наследников
- [LoadingView](TechDocs/uikit_utils.md#loadingview) - набор классов и протоколов для удобного отображения загрузочных состояний с шиммерами
## Example
Все вышеперечисленное можно увидеть в Example-проекте. Для его корректного запуска и конфигурации скачайте репозиторий и выполните команду `make init` перед тем как его запустить.
## Changelog
Список всех изменений можно посмотреть в этом [файле](./CHANGELOG.md).
## Contributing
- Туториал по добавлению собственной утилиты можно найти [здесь](./ADD_NEW_UTIL_TUTORIAL.md)
- Правила работы с репозиторием - [здесь](./CONTRIBUTING.md)
## License
[MIT License](./LICENSE)