ios oss

Добро пожаловать в приложение Kickstarter для iOS с открытым исходным кодом! Заходите, разувайтесь, подождите немного — узнайте, как команда Kickstarter создала и продолжает создавать приложение.

Мы также открыли исходный код нашего приложения для Android и читайте больше о нашем пути к открытому исходному коду здесь.

Начиная

1. Установите Хкод. В настоящее время мы поддерживаем XCode 14.3 Swift 5.8.
2. Клонируйте этот репозиторий.

* Чтобы предоставить макетную версию, которая немедленно предоставляет жестко запрограммированные данные, установите KsApi.Secrets.isOSS = true .

Некоторые интересные вещи для изучения

Если вы просто хотите быстро взглянуть на несколько вещей, которыми мы особенно гордимся, не ищите дальше:

• Каталог снимков в каждой функциональной папке Kickstarter-Framework-iOS вместе содержит около 600 снимков экрана различных экранов на каждом языке, устройстве и в крайнем случае, и мы хотим, чтобы они оставались верными. Например, спонсор просматривает проект на японском языке здесь или автор просматривает свою панель управления на немецком языке и на iPad здесь.

• Мы используем модели представлений как легкий способ изолировать побочные эффекты и использовать функциональное ядро. Мы пишем их как чистое сопоставление входных сигналов с выходными сигналами и тщательно их тестируем, включая тесты на локализацию, доступность и отслеживание событий.

Тестирование проекта

• Запустите все тесты из командной строки, запустив make test-all .
• Запустите тесты отдельной схемы, выбрав эту схему в Xcode и нажав CMD+U.

Документация

Раз уж мы этим занимаемся, почему бы не поделиться нашими документами? Ознакомьтесь с нативной документацией, которую мы написали, чтобы получить дополнительную документацию.

Зависимости

Мы активно используем следующие проекты, поэтому может быть полезно с ними ознакомиться:

первая вечеринка

• Прелюдия: Основа типов и функций, которых, по нашему мнению, не хватает в стандартной библиотеке Swift.

• ReactiveExtensions: коллекция операторов, которые мы хотели бы добавить в ReactiveCocoa. Построен на основе ReactiveSwift.

третья сторона

• AlamofireИзображение
• SnapshotТестирование
• Аполлон
• Полоса
• Зимородок
• SwiftSoup
• Фейсбук
• Огневая база
• Центр приложений
• Аппбой
• ПериметрX

Уведомления о сторонних библиотеках в этом репозитории содержатся в NOTICE.md .

Содействие

Мы хотим, чтобы этот проект стал образовательным ресурсом: мы рады поделиться нашими победами, ошибками и методологией разработки iOS, работая открыто. Наша основная задача — продолжать улучшать приложение для наших пользователей в соответствии с нашей дорожной картой.

Лучший способ оставить отзыв и сообщить об ошибках — открыть проблему на GitHub. Обязательно укажите свою операционную систему, устройство, номер версии и действия по воспроизведению обнаруженных ошибок. Помните, что все участники должны следовать нашему кодексу поведения.

Нормы поведения

Мы стремимся делиться своими знаниями и открытиями, ежедневно работая над улучшением нашего продукта для нашего сообщества в безопасном и открытом пространстве. Мы работаем так, как живем, будучи добрыми и внимательными людьми, которые учатся и растут, предоставляя и получая положительные, конструктивные отзывы. Мы оставляем за собой право удалять или запрещать любое поведение, нарушающее этот базовый принцип уважения.

Находите это интересным?

Мы тоже, и мы нанимаем!

Лицензия

 Copyright 2021 Kickstarter, PBC.

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

   http://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.