Wiki source code of Running KEITH
Version 1.1 by Soeren Domroes on 2019/02/07 16:37
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | == Running the already build LS == | ||
| 2 | |||
| 3 | Go to the latest [[Bamboo build>>url:https://rtsys.informatik.uni-kiel.de/bamboo/browse/KISEMA-NSI||shape="rect"]] and go to Artifacts. | ||
| 4 | |||
| 5 | [[image:attach:image2019-2-7_17-46-58.png]] | ||
| 6 | |||
| 7 | Select Language Server Zip and download the LS and unpack it somewhere. | ||
| 8 | |||
| 9 | Locate the kieler.ini file. Depending on the OS it has a different location (linux; toplevel, windows, toplevel, mac: Content/Eclipse/kieler.ini) | ||
| 10 | |||
| 11 | Paste the following at the beginning of the ini-file: | ||
| 12 | |||
| 13 | {{code language="bash"}} | ||
| 14 | -application | ||
| 15 | de.cau.cs.kieler.language.server.LanguageServer | ||
| 16 | -noSplash | ||
| 17 | {{/code}} | ||
| 18 | |||
| 19 | Since an eclipse application is built, this is needed to start the LS without a splashscreen. | ||
| 20 | |||
| 21 | If you want to connect that LS via socket to your Theia application (KEITH) add the following to the vmargs: | ||
| 22 | |||
| 23 | {{code}} | ||
| 24 | -Dport=5007 | ||
| 25 | {{/code}} | ||
| 26 | |||
| 27 | 5007 is the standard port KEITH is currently connecting to in socket mode. You can find this port in your Theia application at the following location: | ||
| 28 | |||
| 29 | Assume you are in the [[keith >>url:https://git.rtsys.informatik.uni-kiel.de/projects/KIELER/repos/keith/browse||shape="rect"]]repository. Go to {{code language="none"}}keith-app{{/code}}, you should see something like this: | ||
| 30 | |||
| 31 | [[image:attach:image2019-2-7_17-58-22.png]] | ||
| 32 | |||
| 33 | Open the {{code language="none"}}package.json{{/code}}. In the{{code language="none"}} package.json{{/code}} are several scripts defined. | ||
| 34 | |||
| 35 | [[image:attach:image2019-2-7_18-0-7.png]] | ||
| 36 | |||
| 37 | The {{code language="none"}}LSP_PORT{{/code}} option is used to activate the connection via socket. It is also possible to specify a relative location to a LS via {{code language="none"}}LS_PATH=<path to LS>{{/code}}. | ||
| 38 | |||
| 39 | You can also set these options for an already build [[keith electron app>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/files/nightly/sccharts-integration/||shape="rect"]]. | ||
| 40 | |||
| 41 | == Setting up a KEITH developer setup... == | ||
| 42 | |||
| 43 | General requirements: | ||
| 44 | |||
| 45 | * Java (for eclipse, you know how to get Java) | ||
| 46 | * node | ||
| 47 | * npm (whatever node installs) | ||
| 48 | * yarn (latest version) | ||
| 49 | * Python (2.7.X) | ||
| 50 | * gcc, g++, and make (for native dependencies of some npm packages) | ||
| 51 | * [[Visual Studio Code>>url:https://code.visualstudio.com/||shape="rect"]] (latest version) | ||
| 52 | * eclipse installer | ||
| 53 | * a cloned [[keith >>url:https://git.rtsys.informatik.uni-kiel.de/projects/KIELER/repos/keith/browse||shape="rect"]]repository | ||
| 54 | |||
| 55 | == ... on linux: == | ||
| 56 | |||
| 57 | (Theia has a [[guide >>url:https://www.theia-ide.org/doc/authoring_extensions||shape="rect"]]for extension development that might be helpful) | ||
| 58 | |||
| 59 | install node 8: | ||
| 60 | |||
| 61 | {{code}} | ||
| 62 | curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.5/install.sh | bash | ||
| 63 | nvm install 8 | ||
| 64 | {{/code}} | ||
| 65 | |||
| 66 | Install python if you haven't (remember: Python 2: , Python 3: ). | ||
| 67 | |||
| 68 | {{code language="none"}} | ||
| 69 | Install yarn (a package manager build on the package manager npm): | ||
| 70 | {{/code}} | ||
| 71 | |||
| 72 | {{{}}} | ||
| 73 | |||
| 74 | \\ | ||
| 75 | |||
| 76 | {{code}} | ||
| 77 | npm install -g yarn | ||
| 78 | {{/code}} | ||
| 79 | |||
| 80 | \\ | ||
| 81 | |||
| 82 | == ... on windows: == | ||
| 83 | |||
| 84 | Install [[node 8>>url:https://nodejs.org/download/release/v8.15.0/||shape="rect"]] for windows. I personally used the {{code language="none"}}.msi{{/code}}. | ||
| 85 | |||
| 86 | Use that to install windows-build-tools: | ||
| 87 | |||
| 88 | {{code}} | ||
| 89 | npm install -g windows-build-tools | ||
| 90 | {{/code}} | ||
| 91 | |||
| 92 | This installs make, gcc, g++, python and all this (I am not sure about yarn, anyway you can always install yarn the same way as in the linux description) | ||
| 93 | |||
| 94 | == ... on mac: == | ||
| 95 | |||
| 96 | Get a package manager, something like [[brew>>url:https://brew.sh/index_de||shape="rect"]]. | ||
| 97 | |||
| 98 | Use brew to install all necessary stuff. | ||
| 99 | |||
| 100 | Apparently there is an issue with xcode-select: [[Theia developers>>url:https://github.com/theia-ide/theia/blob/master/doc/Developing.md||shape="rect"]] recommend the following: | ||
| 101 | |||
| 102 | {{code}} | ||
| 103 | xcode-select --install | ||
| 104 | {{/code}} | ||
| 105 | |||
| 106 | \\ | ||
| 107 | |||
| 108 | \\ | ||
| 109 | |||
| 110 | After doing this for your OS all that is missing is running KEITH (in developer setup) and setting up your eclipse for language server development). | ||
| 111 | |||
| 112 | == How run KEITH in developer setup (socket) == | ||
| 113 | |||
| 114 | Run the following to build and run KEITH in its developer setup (in socket mode, so the LS has to be started separately) | ||
| 115 | |||
| 116 | {{code language="bash"}} | ||
| 117 | yarn && cd keith-app && yarn run socket | ||
| 118 | {{/code}} | ||
| 119 | |||
| 120 | \\ | ||
| 121 | |||
| 122 | == Setting up your eclipse == | ||
| 123 | |||
| 124 | For everything not mentioned here refer to [[Configuring Eclipse>>doc:KIELER.Configuring Eclipse||shape="rect"]] guide. | ||
| 125 | |||
| 126 | Use the installer go to advanced mode, add the kieler url. Then select first pragmatics and after that semantics (that is very important). | ||
| 127 | |||
| 128 | Select the Theia stream for both of them and use the latest eclipse if possible. Set the targetplatform to photon and finish. TODO | ||
| 129 | |||
| 130 | \\ | ||
| 131 | |||
| 132 | \\ | ||
| 133 | |||
| 134 | \\ |