Skip to content

Commit

Permalink
Update Readme + Add Resources
Browse files Browse the repository at this point in the history
  • Loading branch information
nlogozzo committed Jan 4, 2024
1 parent a9a4e3a commit b38bd98
Show file tree
Hide file tree
Showing 6 changed files with 95 additions and 13 deletions.
51 changes: 38 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,48 @@
# libaura

A cross-platform base for native Nickvision applications.
<img width='96' height='96' alt='Logo' src='resources/logo.png'/>

**A cross-platform base for native Nickvision applications.**

libaura provides Nickvision apps with a common set of cross-platform (Windows and Linux) APIs for managing system and desktop app functionality such as network management, taskbar icons, translations, app updates, and more.

## Documentation

Documentation for this library and its modules can be found [here](/docs).

## Installation with Conan
## Dependencies

The following are a list of dependencies and their versions used by libaura.

These dependencies should also be installed on your system and linked to your project when using libaura as well, since some libaura headers reference these dependencies.

Following the [build instructions](#building-and-installation) below using conan, will ensure these dependencies and their proper versions are installed for your platform.

**However, note, as stated above, when linking to libaura in your project, you MUST also link to these dependencies to ensure proper linkage to libaura.**

### All Platforms
- boost/1.83.0
- gtest/1.14.0 (**Only if building test suite**)
- jsoncpp/1.9.5
- libcurl/8.4.0
- libgettext/0.22
- maddy/1.3.0
- sqlcipher/4.5.1

TODO
### Linux Only
The above dependencies must be installed, plus the following for linux systems:
- glib/2.78.1
- libsecret/0.20.5
- libuuid/1.0.3

## Manual Building and Installation
libaura uses Conan package manager for resolving dependencies and CMake as it's build system.
## Building and Installation
libaura uses Conan package manager for resolving dependencies and CMake as its build system.

Ensure both `conan` and `cmake` are installed on your system before building libaura.
Ensure both `conan` and `cmake` are installed on your system before building and installing libaura.

A C++20 compiler is also required to build libaura.

### Windows
### Windows 10/11
Visual Studio 2022 with C++ Desktop workload is required to be installed.

1. First, clone/download the repo.
Expand All @@ -30,10 +53,11 @@ Visual Studio 2022 with C++ Desktop workload is required to be installed.
1. From the `build` folder, run `cmake .. -G "Visual Studio 17 2022" -DCMAKE_TOOLCHAIN_FILE="generators/conan_toolchain.cmake"`.
- To skip building libaura's test suite, add `-DBUILD_TESTING="Off"` to the end of the command.
1. From the `build` folder, run ``cmake --build . --config Release`.
1. After these commands, libaura will be successfully built and its binaries can be found in the `Release` folder of the `build` folder.
1. After these commands complete, libaura will be successfully built and its binaries can be found in the `Release` folder of the `build` folder.
1. To install libaura to the system, from the `build` folder, run `cmake --install . --prefix "PATH_TO_INSTALL_DIR"`.
- Replace `PATH_TO_INSTALL_DIR` with the path to a folder to install libaura to. This is usually a dependencies folder set up by the programmer, added to the PATH variable, to allow linking to said dependencies.
1. If contributing to upstream, remove `conanfile-windows.txt` and `conanprofile-windows.txt` from the repo's root directory as to not accidentally add and commit them.
- Replace `PATH_TO_INSTALL_DIR` with the path to a folder to install libaura to.
- This is usually a dependencies folder set up by the programmer, added to the PATH variable, to allow linking to said dependencies.
1. If contributing to upstream, remove `conanfile.py` and `conanprofile-windows.txt` from the repo's root directory as to not accidentally add and commit them.

### Linux
1. First, clone/download the repo.
Expand All @@ -46,8 +70,9 @@ Visual Studio 2022 with C++ Desktop workload is required to be installed.
1. From the `build` folder, run `cmake .. -DCMAKE_TOOLCHAIN_FILE="Release/generators/conan_toolchain.cmake" -DCMAKE_BUILD_TYPE=Release`.
- To skip building libaura's test suite, add `-DBUILD_TESTING="Off"` to the end of the command.
1. From the `build` folder, run `cmake --build`.
1. After these commands, libaura will be successfully built and its binaries can be found in the `Release` folder of the `build` folder.
1. After these commands complete, libaura will be successfully built and its binaries can be found in the `Release` folder of the `build` folder.
1. To install libaura to the system, from the `build` folder, run `cmake --install . --prefix "PATH_TO_INSTALL_DIR"`.
- Replace `PATH_TO_INSTALL_DIR` with the path to a folder to install libaura to. This is usually a dependencies folder set up by the programmer, added to the PATH variable, to allow linking to said dependencies.
- Replace `PATH_TO_INSTALL_DIR` with the path to a folder to install libaura to.
- This is usually a dependencies folder set up by the programmer, added to the PATH variable, to allow linking to said dependencies.
- On linux, `PATH_TO_INSTALL_DIR` would usually be `/usr`.
1. If contributing to upstream, remove `conanfile-windows.txt` and `conanprofile-windows.txt` from the repo's root directory as to not accidentally add and commit them.
1. If contributing to upstream, remove `conanfile.py` and `conanprofile-windows.txt` from the repo's root directory as to not accidentally add and commit them.
3 changes: 3 additions & 0 deletions resources/aura-symbolic.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/logo-r.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
27 changes: 27 additions & 0 deletions resources/logo-r.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added resources/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
27 changes: 27 additions & 0 deletions resources/logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit b38bd98

Please sign in to comment.