Skip to content

Commit df34b5d

Browse files
authored
Update README.md
1 parent d3ce708 commit df34b5d

File tree

1 file changed

+58
-7
lines changed

1 file changed

+58
-7
lines changed

README.md

Lines changed: 58 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,63 @@
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
32

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.
54

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
711

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)
918

10-
The `LICENSE` file should contain the license you intend for the source code in the repo.
19+
## Getting Started
1120

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

Comments
 (0)