Working with the Appweb Source Code
Appweb releases are available as either a binary or source code distribution. It is your choice which distribution you choose, but the source code distribution has several advantages:
- You can recompile Appweb to optimize it for your specific system environment.
- You can reconfigure Appweb using a wide variety of configuration options to select the specific features that you require.
- You can minimize the memory footprint and decrease the securable surface area.
Getting the Source Code
With each Appweb release, a complete source code snapshot is provided. You can get the latest source code from the download site or you can access the source code repository.
Source Repository
The Appweb source code is hosted in a Git repository. We provide open read-only access. Write access is available to regular contributing developers. To check out the source use this command:
$ git clone http://github.com/embedthis/appweb-4
You can also view the repository at https://github.com/embedthis/appweb-4. This is also a convenient way to get the source code.
Repository Branches
The repository has three branches for various phases of development and release: Master, Dev and Stable.Master Branch
The Master branch in the repository source code is the code base for the next minor and major release. It will contain the latest features and fixes, but it will also contain bugs and issues that have not been resolved. For this reason use of the repository source code is not recommended for production or development use.Dev Branch
The Dev branch is updated when the Master branch is relatively steady and usable, but prior to release. The Dev branch is used to create Beta releases. It is not as bug-free as the Stable branch and yet has most of the features in the master branch.
Stable Branch
The stable branch is for ongoing maintenance of the current stable release.
Building Appweb from Source
The Appweb source distribution contains all the required source files, headers, tools, and test framework to reconfigure, build, and verify Appweb. For details, see the building from source instructions.
Running Unit Tests
The Appweb source code uses a large test suite to verify correct operation and trap regression errors. Run make test to exercise the unit tests.
Porting the Source to a New Platform
Appweb currently runs on a wide variety of operating platforms including: FreeBSD, Linux, MAC OS X and Windows. If your system is not one of these, you may like to try porting Appweb to your system. See the detailed porting instructions for tips on this process.