Skip to content

Commit 4a5b926

Browse files
committed
AirAPI_Example_0.2.0Build1-- standalone macOS app for Intel (rosetta with M-Series), fixed disconnection crash, removed all external lib requirements
1 parent cd0b2b1 commit 4a5b926

File tree

3 files changed

+52
-16
lines changed

3 files changed

+52
-16
lines changed

.gitignore

+3
Original file line numberDiff line numberDiff line change
@@ -88,3 +88,6 @@ fastlane/test_output
8888
# https://github.com/johnno1962/injectionforxcode
8989

9090
iOSInjectionProject/
91+
92+
# mac stuff
93+
*.DS_Store
Binary file not shown.

README.md

+49-16
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,46 @@
11
# AirAPI_Mac-Dist
2-
Pre-release versions of AirAPI apps.
2+
Pre-release versions of AirAPI SDK apps for macOS.
33

4-
## Releases
4+
## Release Info
5+
6+
- 0.2.0, build 1: Pre-alpha update to the test bench & telemetry project for Nreal Air.
7+
8+
### Latest Release Notes:
9+
10+
Updates / Fixes
11+
12+
- Everything is pre-built and included within the application-- it should "just work"
13+
14+
- After much R&D, the underlying libraries are now compiled and using CMake such that they are directly included with the app-- no more weird developer stuff with installing hidapi, or putting things on path (you can remove them now if you installed 0.1.0)
15+
16+
- Fixed crash on "stop connection"
17+
18+
- Was due to an underlying c++ threading issue which is now resolved when disconnecting
19+
20+
21+
Notes:
22+
23+
- In order to simplify the R&D, the ability to build for M-Series was temporarily disabled in Xcode-- but it should still run on M-Series with Rosetta
24+
25+
- Please let us know if you are able to run with Rosetta on M-Series
26+
27+
- If you have any crashes or issues, please [go to issues](https://github.com/GigabiteLabs/AirAPI_Mac-Dist/issues) and create a report-- more information is better, if you can include a crash report that would be 100% best (like this fine tester, [right here](https://github.com/GigabiteLabs/AirAPI_Mac-Dist/issues/1))
28+
29+
- No major changes or improvements to the UI were done in this build, this one is purely about smoothing out the ability to run the app, and making it as accessible to as many mac users as possible.
30+
31+
32+
Known Issues:
33+
34+
- The window is not resizable, and may be too large on some macs to see all of the buttons macs
35+
36+
- apologies, this is an autolayout bug that was just beyond the goal of this release
37+
38+
- this will be fixed in the next release.
39+
40+
- Connection status UI does not ever update or reflect the actual status
41+
42+
- on it, will be resolved in the next release
543

6-
- 0.1.0, build 1: Pre-alpha releae of test bench & telemetry API project for Nreal Air.
744

845
## How to install
946

@@ -13,31 +50,27 @@ Disclaimer: this project is aimed at fellow developers and power users, proceed
1350

1451
2. Unzip on your Mac
1552

16-
3. You will find AirAPI_Example.app and some library files in `libs/` that you will need move to some location on-path, that is, discoverable by your system so this app can run (it will crash if don't have these in your enironment):
17-
18-
- all of the files in `libs/` need to go in a library folder (or aliased to one) within macOS, like `/usr/local/lib`
19-
20-
- once moved, make sure both libs have +x, or use `chmod +x (lib)` for both
53+
3. You will find AirAPI_Example.app
2154

22-
- all of the header files in `include/` folder will need move to some location on-path like `/usr/local/include`
55+
4. Open another finder window and move AirAPIExample.app to your `/Applications` folder
2356

24-
- once done with the libraries, simply move the .app to `~/Applications`
57+
5. Launch it:
2558

26-
- In the next step you will be warnied by Apple that this app is unsafe etc-- it's safe, just go to `~/Applications` in Finder and use `option + right-click` and then click "open". Then clock "open" again, this will by-pass gatekeeper
59+
- You will be warnied by Apple that this app is unsafe etc-- it's safe.
2760

28-
- If the above doesn't work and you can't open it, to to your settings and [make sure you allow apps from "trusted developers"](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) and click this link if you have any more issues
61+
- To launch: go to `~/Applications` in Finder and use `option + right-click` and then click "open". Then clock "open" again, this will by-pass gatekeeper
2962

30-
That's it, now plug in your Nreal Air to you Mac and click "connect" if the globe does not automatically start tracking your glasses positional data.
63+
- If the above doesn't work and you can't open it, to to your settings and [make sure you allow apps from "trusted developers"](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac) and click this link if you have any more issues
3164

32-
Note: if it is crashing on launch or not opening, go back and [make sure your libs are on your $PATH](https://www.macgasm.net/news/tips/adding-a-new-location-to-your-path-variable-within-terminal/)
65+
That's it, now plug in your Nreal Air and click "connect" (if the globe does not automatically start tracking your Nreal Air postitional updates)
3366

3467
## Compatibility
3568

3669
This SDK is verified compatible with the following:
3770

38-
- macOS Ventura
71+
- macOS Ventura (Intel)
3972
- Swift v5^ & and Xcode 14^
4073
- SceneKit
4174
- RealityKit
4275

43-
We need your feedback about M-Series-- did it work for you? If not, please get in touch.
76+
We need your feedback about M-Series-- did it work for you? If not, please get in touch or submit a [git issue](https://github.com/GigabiteLabs/AirAPI_Mac-Dist/issues)

0 commit comments

Comments
 (0)