GraphQL and React go together like peanut butter and jelly, especially if you use a GraphQL client/compiler like Relay or Apollo.
But GraphQL services are only implemented on the server. When using React Native or React JS in a hybrid application, you typically have a native application which hosts islands or entire pages of UI rendered with React components, and you might like to display content that you've cached offline or that you otherwise generate on the client without needing to declare a separate data interface or require a server round trip to load it.
This project includes a graphqlservice
library with the core functionality of a GraphQL service
and a schemagen
utility to generate types for your custom GraphQL service schema definition. Once
you implement the pure virtual methods on the object interfaces and add hooks to the Relay
Network Layer/Apollo
Terminating Link to call your
service, you can use the same GraphQL client code to access your native data source or a GraphQL
service online. You might even be able to share some more of that code between a progressive web
app and your native/hybrid app.
I created a couple of sample projects to demonstrate integrating the schema.today.graphql service into an Electron app. They're available under my personal account, feel free to use either or both of these as a starting point to integrate your own generated service with Node or Electron:
- electron-cppgraphql: Node Native Module which compiles against the version of the Node headers included in Electron.
- cppgraphiql: Electron app which consumes
electron-cppgraphql
and exposes an instance of GraphiQL on top of it.
First, clone this repo, then make sure you have the dependencies. Acquiring the dependencies is a bit different depending on your platform.
I've tested this on Windows with Visual Studio 2017 and Linux using an Ubuntu instance running in WSL.
I added a vcpkg port for this project, if you have vcpkg you can also install everything with vcpkg install cppgraphqlgen
.
For now, I'm maintaining compatibility with C++11 for maximum portability. I picked a few projects as dependencies:
- JSON support: RapidJSON.
- GraphQL parsing: Parsing Expression Grammar Template Library (PEGTL), which is part of The Art of C++ library collection. Specifically, you should use the 2.7.x branch of PEGTL instead of master since it's compatible with C++11.
- Unit testing: Google Test for the unit testing framework.
The build system for this project uses CMake. You'll need to have all 3 dependencies installed on your system along with CMake to build this project.
Vcpkg can install the dependencies from source on either platform, and that's what I'm using on
Windows. Use vcpkg install rapidjson pegtl gtest
to get all of them.
This approach works well on Linux. I've done all of my testing for Linux with WSL using vcpkg.
All of these packages dependencies should also be available in NuGet packages if you don't want to use vcpkg but still want to use a package manager.
Clone each of the repos from GitHub and follow the installation instructions in the README.md files.
See GraphQLService.h for the base types implemented in
the facebook::graphql::service
namespace. Take a look at Today.h and Today.cpp
to see a sample implementation of a custom schema defined in schema.today.graphql
for testing purposes.
All of the generated files are in the samples directory. If you modify the code
generator in SchemaGenerator.* and rebuild, make install
will update them. Please remember to
include updating the samples in any pull requests which change them.
There are a couple of options for building on Windows. You can either run CMake from the command line, or you can use the CMake integration in Visual Studio. They behave a little differently, but I prefer building and running tests in Visual Studio, then optionally performing a Release build and install from the command line.
Use the Open Folder command to open the root of the repo. If you've installed the dependencies with vcpkg and run its Visual Studio integration command, Visual Studio should know how to build each of the targets in this project automatically. I've only been able to get x86-debug to work so far in Visual Studio though, it doesn't switch properly between the Debug and Release dependencies installed by vcpkg on my machine.
To build from the command line, run:
cmake -DCMAKE_TOOLCHAIN_FILE=<...path to vcpkg root...>/scripts/buildsystems/vcpkg.cmake .
once
to populate the Visual Studio solution files, then:
msbuild cppgraphql.sln
to perform the build.
You can also build optional .vcxproj
project files with msbuild to perform the associated task,
e.g. installing or running tests.
If you want to make a Release build, add the /p:Configuration=Release
argument to the msbuild
command line.
To build everything on Linux run:
cmake .
make
You can then optionally install the public outputs by running:
sudo make install
.
Run the unit tests with tests
from the build output directory.
If you want to try an interactive version, you can run test_today
and paste in queries against
the same mock service or load a query from a file on the command line.
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at [email protected]. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.