source: launchers/macosx/README.md @ 22a0f39

Last change on this file since 22a0f39 was 22a0f39, checked in by meeh <meeh@…>, 23 months ago

Mac OS X Launcher:

  • Enabled Apple's "Hardened Runtime", however unsecure memory had to be allowed to spawn java etc.
  • Updated docs about Event Manager code
  • Make the launcher handle cases where extract is incomplete or invalid
  • Bugfixes as always
  • Property mode set to 100644
File size: 2.2 KB
Line 
1# The Mac OS X Launcher
2
3## The Event Manager
4
5This is some Swift code which makes the application use events to signal the different compoents of the application. This seems to be the cleanest way since we're doing java subprocesses and so on. This can also be named a publish-subscribe system as well. If you're familiar with Javascript it would be a handy skill.
6
7### Event Overview
8
9| Event name | Details sent as arguments | Description |
10| ------------- | ------------- | ------------- |
11| router_start | nothing | This event get triggered when the router starts |
12| router_exception | exception message | This will be triggered in case something within the functions that start the java (router) subprocess throws an exception |
13| java_found | the location | This will be triggered once the DetectJava swift class has found java |
14| router_must_upgrade | nothing | This will be triggered if no I2P is found, or if it's failing to get the version from the jar file |
15| extract_completed | nothing | This is triggered when the deployment process is done extracting I2P to it's directory |
16| router_can_start | nothing | This event will be triggered when I2P is found and a version number has been found, router won't start before this event |
17| router_stop | error if any | Triggered when the router subprocess exits |
18| router_pid | the pid number as string | Triggered when we know the pid of the router subprocess |
19| router_version | the version string | Triggered when we have successfully extracted current I2P version |
20| extract_errored | the error message | Triggered if the process didn't exit correctly |
21
22## Misc
23
24**Note** this project is WIP, cause Meeh has yet to merge in Obj-C/Swift code for GUI stuff in OSX.
25
26However, this is a thin wrapper launching both Mac OS X trayicon and the I2P router - and make them talk together.
27
28More code will be merged in, it's just a f* mess which Meeh needs to clean up and move into repo.
29
30## Howto build
31
32You can both build the project from the Xcode UI or you can build it from command line.
33
34An example build command:
35`xcodebuild -target I2PLauncher -sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk`
36
37
Note: See TracBrowser for help on using the repository browser.