|
1 | | -# devnet-template |
2 | | -This provides a template repository for creating or importing repos in the CiscoDevNet organization on GitHub.com. |
| 1 | +# SpacesWayFindingSDK-SampleApp-iOS |
3 | 2 |
|
4 | | -Please use this template as a guide to creating a repo that encourages contributions and shows thoughtful maintenance strategies. |
| 3 | +A sample iOS application demonstrating the integration and usage of the Spaces WayFinding SDK for indoor navigation and mapping. This project showcases how to use the SDK in a real-world scenario, including map display, building selection, and pathfinding features. |
5 | 4 |
|
6 | | -The `CODE_OF_CONDUCT.md` reflects our standards for interaction. |
| 5 | +## Features |
| 6 | +- Indoor map display using Mapbox |
| 7 | +- Building and floor selection |
| 8 | +- Pathfinding and navigation |
| 9 | +- Custom event handling for map and navigation events |
| 10 | +- Example integration of SpacesWayFindingSDK and SpacesWayFindingApp frameworks |
7 | 11 |
|
8 | | -The `CONTRIBUTING.md` file instructs new contributors on how to communicate with the project maintainers, report issues, provide pull requests, reviewing contributions, and how to version control releases. |
| 12 | +## Requirements |
| 13 | +- Xcode 13 or later |
| 14 | +- iOS 16.0 or later |
| 15 | +- Swift 5.0 or later |
| 16 | +- Mapbox SDK (included as xcframework) |
| 17 | +- SpacesWayFindingSDK and SpacesWayFindingApp (included as xcframeworks) |
9 | 18 |
|
10 | | -The `LICENSE` file should contain the license you intend for the source code in the repo. |
| 19 | +## Getting Started |
11 | 20 |
|
12 | | -The `SECURITY.md` file describes security policies and procedures including reporting a security-related bug and the policy on disclosure. |
| 21 | +### 1. Clone the Repository |
| 22 | +```sh |
| 23 | +git clone https://github.com/CiscoDevNet/SpacesWayFindingSDK-SampleApp-iOS.git |
| 24 | +cd SpacesWayFindingSDK-SampleApp-iOS |
| 25 | +``` |
| 26 | + |
| 27 | +### 2. Open the Project |
| 28 | +Open `SpacesWayFindingSDK-SampleApp-iOS.xcodeproj` in Xcode. |
| 29 | + |
| 30 | +### 3. Build and Run |
| 31 | +- Select a simulator or a physical device. |
| 32 | +- Build and run the app. |
| 33 | + |
| 34 | +### 4. SDK Integration |
| 35 | +The required frameworks (`Mapbox`, `SpacesWayFindingSDK`, `SpacesWayFindingApp`) are included in the `Frameworks/` directory as `.xcframework` bundles. Ensure they are linked in the Xcode project settings. |
| 36 | + |
| 37 | +## Project Structure |
| 38 | +- `AppDelegate.swift`, `SceneDelegate.swift`: App lifecycle management |
| 39 | +- `BuildingsViewController.swift`: Building selection UI |
| 40 | +- `WidgetViewController.swift`: Main map and navigation UI |
| 41 | +- `WayfindingHelper.swift`: Helper for SDK integration |
| 42 | +- `Custom*Handler.swift`: Custom event handlers for map and navigation events |
| 43 | +- `Frameworks/`: Contains required SDKs as xcframeworks |
| 44 | +- `Assets.xcassets/`: App icons and color assets |
| 45 | +- `Base.lproj/`: Storyboards for UI |
| 46 | + |
| 47 | +## Documentation |
| 48 | +- See `WF-SDK-V1.2-Document.pdf` for detailed SDK documentation and API reference. |
| 49 | + |
| 50 | +## Contributing |
| 51 | +See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. |
| 52 | + |
| 53 | +## License |
| 54 | +See [LICENSE](LICENSE) for license information. |
| 55 | + |
| 56 | +## Security |
| 57 | +See [SECURITY.md](SECURITY.md) for security policies. |
| 58 | + |
| 59 | +## Code of Conduct |
| 60 | +See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for community standards. |
| 61 | + |
| 62 | +## Support |
| 63 | +For questions or support, please refer to the documentation or open an issue in this repository. |
0 commit comments