Part of my final year project at Imperial College London.
This is still work in progress, but feedback is much appreciated!
Please read the getting started guide to see how Native Calls works and how to use it.
To build the project, you'll need the following requirements:
To build, simply run
Note: I have only tested this on Mac OSX and linux. Compiling on Windows will probably break.
To see it in action, make sure you have built the project (see above). Then, type
make serve. This will start a server in the project directory.
Visit the index page, by typing http://localhost:3000/ into your browser.
To install the C++ library to your SDK, run
This will build the library for all toolchains and configurations.
This will also install the generator,
If you want to only install
pprpcgen without cloning this repository, you can type
npm install -g native-calls.
To run all tests, type
You can also test each component individually:
make testruns all tests
make nodetestruns generator tests
make cpptestruns C++ rpc framework tests
make eetestruns end-to-end tests
The tests are run using karma.
If you're interested in contributing, here are some things that still need to be done...
- Generating JS skeletons for the Emscripten code (possibly in combination pepper.js) and provide automatic fallback for browsers which don't support Native Client
- Performance optimization, in particular efficient use of binary arrays
- Generating C++ stubs and JS skeletons to allow calls from native into JS code
- Support for transferring binary
You can read some design docs in the docs folder.
The full project report (in progress) is written in TeX and is found in the report repo.
How to set up the Native Calls project in Eclipse.
A project has already been created and is in the repository. All you need to do is to configure it with your
- Download eclipse CDT
- Clone the Native Calls project.
- Copy the
.cproject.samplefile and save it as
- Open eclipse
- Import the project.
Existing Project into Workspace
- Right click on the project and click properties.
Enivronment, set the
NACL_SDK_ROOTvariable to be the NaCl SDK location. Save for all configurations.
Build Variables, set the
NACL_SDK_ROOTvariable to be a directory pointing to your NaCl SDK location. Save for all configurations.
- Right click on the project and choose
Rebuildto rebuild the index.
- Done! Clicking the build button runs
You can also set up eclipse to debug the C/C++ application. This is shown in the chromium how-to.