rtRemote

rtRemote

Build Instructions for rtRemote (Linux only)

Building with CMake

1. Build rtCore

   git clone https://github.com/pxscene/pxCore
   cd pxCore
   mkdir temp
   cd temp
   cmake -DBUILD_RTCORE_LIBS=ON -DBUILD_PXCORE_LIBS=OFF -DBUILD_PXSCENE=OFF ..
   cmake --build .
   cd ../../
   

2. Build libuv (required by uWebSockets)

   git clone https://github.com/libuv/libuv.git
   cd libuv
   git reset --hard d989902ac658b4323a4f4020446e6f4dc449e25c
   ./autogen.sh
   ./configure
   make
   cd ..
   

3. Build uWebSockets

   git clone https://github.com/uNetworking/uWebSockets.git
   cd uWebSockets
   git checkout v0.14
   git reset --hard 10ab3cd0360c62665bda113cde9e7c81714855ba
   CFLAGS=" -I../libuv/include -DSO_REUSEPORT" make
   cd ..
   

4. Build rtRemote

   git clone https://github.com/pxscene/rtRemote.git
   cd rtRemote
   mkdir temp
   cd temp 
   cmake -DRT_INCLUDE_DIR="../pxCore/src/;../uWebSockets/src" -DRT_LIBRARY_DIR="../pxCore/build/glut/;../uWebSockets;../libuv/.libs" -DBUILD_UNICAST_RESOLVER=ON -DBUILD_SAMPLE_APP_SIMPLE=ON ..
   cmake --build . --config Release
   

   The rtRemote libs/apps will be located in rtRemote/out

   All build configurations for rtRemote:

   Build rpcSampleApp: -DBUILD_SAMPLE_APP_SHARED=ON
   Build rpcSampleApp_s: -DBUILD_SAMPLE_APP_STATIC=ON
   Build rtSampleClient and rtSampleServer: -DBUILD_SAMPLE_APP_SIMPLE=ON
   Build rtunicastresolverd: -DBUILD_UNICAST_RESOLVER=ON
   Enable rtRemote debugging: -DENABLE_DEBUG=ON
   Enable rtRemote profiling: -DENABLE_PROFILE=ON
   Disable librtremote shared library building: -DBUILD_SHARED_LIB=OFF
   Disable librtremote static library building: -DBUILD_STATIC_LIB=OFF
   

rtRemote Javascript

Instruction for running the rtRemote javascript library and samples

1. Install node packages

   cd rtRemote/src/js
   npm install
   

2. Run node examples

   terminal 1:
   cd rtRemote/src/js/examples/server  
   node sampleServer.js
   terminal 2:
   cd rtRemote/src/js/examples
   node methodTest.js
   

3. Run commonJS examples (requires rtRemote (above))

   cd rtRemote/out
   edit rtremote.conf and set rt.rpc.client.socket_type=websocket (instead of csocket)
   ./rtSampleServer &
   ./rtunicastresolverd
   in browser run rtRemote/src/js/lib-ecma/test_sample_server.html
   results visible in console log