https://github.com/minikin/swiftui-mapkit

SwiftUI meets MapKit
https://github.com/minikin/swiftui-mapkit

combine ios reactive-programming swift swiftui swiftui-example swiftui-mapkit xcode

Last synced: about 1 year ago
JSON representation

SwiftUI meets MapKit

• Host: GitHub
• URL: https://github.com/minikin/swiftui-mapkit
• Owner: minikin
• License: mit
• Created: 2019-08-14T07:49:49.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-08-16T09:06:32.000Z (over 1 year ago)
• Last Synced: 2025-03-08T17:54:27.625Z (about 1 year ago)
• Topics: combine, ios, reactive-programming, swift, swiftui, swiftui-example, swiftui-mapkit, xcode
• Language: Swift
• Homepage:
• Size: 973 KB
• Stars: 21
• Watchers: 2
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# SwiftUI meets MapKit

SwiftUI meets MapKit is an iOS demo application.



## Meta

**State:** development

**Point People:** [@minikin](https://github.com/minikin)

**CI:** [![Build Status](https://app.bitrise.io/app/693d5288e6e84421/status.svg?token=LSxCFwkI7mKZNc9SVNhM9w)](https://app.bitrise.io/app/693d5288e6e84421)

---

- [SwiftUI meets MapKit](#swiftui-meets-mapkit)

  - [Meta](#meta)

  - [Requirements](#requirements)

  - [Dependencies](#dependencies)

  - [Installation](#installation)

  - [Running the project](#running-the-project)

  - [Development](#development)

    - [Project Structure](#project-structure)

  - [Run Tests](#run-tests)

  - [Support](#support)

  - [License](#license)

## Requirements

- iOS 13.0+ / macOS 10.14.5+

- Xcode 11.6+

- Swift 5.2+

## Dependencies

In the project I don't use any third party dependencies.

---

## Installation

```sh

git clone https://github.com/minikin/swiftui-mapkit.git && cd swiftui-mapkit

```

---

## Running the project

To run the app from Xcode, open the file `SwiftUIMapKit.xcodeproj` and run the Scheme `SwiftUIMapKit`.

Running from Xcode always launches the app with the build configuration `Debug`.

---

## Development

### Project Structure

In the project folder, there are a few important files:

- `SwiftUIMapKit.xcodeproj`: This is the main Xcode workspace file. To open the project with Xcode, always use this file instead of the project file.

Inside the Xcode project, there are a few separations:

- [`SwiftUIMapKitServices`](https://github.com/minikin/swiftui-mapkit-services) Swift Package

  - Contains foundation sources that are used in multiple components of the app, like a Networking client.

- `SwiftUIMapKit` app target

  - The app target uses `SwiftUIMapKitServices`

  - Inside of the app target, code is separated further with groups

    - There is a group `App` with general app parts used by multiple features, like actions, reducers

    - For each feature (AllVehicles, VehicleDetails, ...) there is an additional group that contains everything that is only necessary for this feature.

---

## Run Tests

The SwiftUIMapKit project contains one unit test target: `SwiftUIMapKitTests`.

- To run all tests from Xcode, select the Scheme `SwiftUIMapKit` and press _CMD_ + _U_ or select test from Xcode's dropdown.

## Support

Post issues and feature requests on the GitHub [issue tracker](https://github.com/minikin/swiftui-mapkit/issues).

## License

ItemsDataSource is released under the MIT license. [See LICENSE](https://github.com/minikin/swiftui-mapkit/blob/master/LICENSE) for details.