-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 VCrayApp-0.0.0.txt 0.0.7 UTF-8 2023-01-07 - ----|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* NFOTOOLS DEVKIT FOR RAYLIB APPS =============================== BUILDING RAYLIB APPS WITH VS DEVELOPER COMMAND PROMPT ----------------------------------------------------- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * CAUTION * * ******* * * * * This is an alpha release of VCrayApp. There is incomplete * * information. Alpha is intended for review and testing of the * * functionality. It requires more self-reliance than expected * * of novice developers. The purpose is gathering feedback from * * trial use. There will be beta releases followed by stable * * releases. There may be breaking changes in that progression. * * Be cautious. Be careful. Here be dragons. * * * * IMPORTANT * * ********* * * * * No VCrayApp support is provided for development using anything * * but the C language and the Microsoft VC C/C++ compiler and * * related developer tools on a Windows desktop PC, laptop or * * Microsoft Surface. * * * * VCRAYAPP 0.0.0 IS BEING TESTED WITH THE RAYLIB 4.0.0 SOURCE * * CODE. RAYLIB 4.2.0 CANNOT BE USED BECAUSE OF A VC/C++ * * INCOMPATIBILITY. VCRAYAPP 0.0.0 CAN ALSO BE USED WITH 3.7.0. * * CONFIRMATION WITH LATER RAYLIB RELEASES IS FUTURE WORK. * * * * * Ramon Santiago's raylib software is written in a clean-form of * * the C Language (C11 standard). Use of the raylib code, include * * files, and the API interfaces requires confidence in the use of * * the C or C++ languages with such libraries. VCrayApp is intended * * to be used directly only for programs written in the C Language. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * The VCrayApp-0.0.0 distribution is available on the web at . Consult that page for the latest status, links to useful related material, and any more-recent version. If there is concern for the authenticity or correctness of any VCrayApp distribution, obtain a full replacement via . VCrayApp is designed to work with versions of Visual Studio that are free for personal/open-source use, including the Visual Studio Build Tools (recommended) and the Visual Studio Community editions. Additional levels of licensed Visual Studio can also be used, all via their Native Tools Command Prompt. PREREQUISITES AND DEPENDENCIES Development with VCrayApp and illustration of usage involves the following tools along with confident use of C Language: * Windows File Explorer * Windows Built-in Zip-Folder Tool * Visual Studio Native Build Tools * Developer Command Prompt * Microsoft VC/C++ Command Line Compiler, CL.exe * raylib *source* code *release* 4.0.0 (or 3.7.0) downloaded and unzipped * A text-editor for work on source code, other files, all in plain text (Visual Studio Code recommended for its C/C++ and Microsoft support) + Git4Win implementation for source-code control + TortoiseGit for File Explorer integration of Git + GitHub Windows Client for public access to development projects + GPG4Win for creation and verification of digital signatures The first seven are essential. The remainder are recommended; those are not required for starting up. There are alternatives. The specific ones happen to be those relied upon in the development of nfoTools projects. For more information on dependencies, see . DOWNLOADS AND SETUP It is recommended that you have already installed Visual Studio Native Build Tools and confirmed that the Developer Command Prompt is operating properly. See . If you have not already done so, choose where on your computer you want to have the raylib source code and your own adjacent projects. See and also the setup arrangement described at and . raylib\ must be setup before VCrayApp can be used. Download VCrayApp from . If a later version is available, consider using that version instead. It is useful to download VCrayApp-0.0.0.zip to a location that you can use as a source of copies for one or more VCrayApp projects. EXTRACTION AND RENAMING OF VCrayApp-0.0.0.zip CONTENT After downloading VCrayApp-0.0.0.zip to a place where you want to keep it, make a copy to a place where you want to use it. Right click on File Explorer VCrayApp-0.0.0.zip and click "Extract all ..." in the context menu that appears. In the "Extract Compressed (Zipped) Folders" Dialog that appears, accept the "Files will be extracted to this folder:" choice that is offered automatically. Check the "Show extracted files when complete" entry. Click "Extract". There should now be a VCrayApp-0.0.0\ sub-folder in the same folder as the Zip file you extracted. Rename that sub-folder to the name you want for this VCrayApp project of yours. This is your project folder. CONFIRMING THE VCrayApp SETUP AND OPERATION Using a Visual Studio Developer Command Prompt, navigate to your project folder and use the command VCrayApp ? To confirm that the project folder is setup properly and that VCrayApp.bat is operating. If that succeeds, use the command VCrayApp -r This will compile raylib components to the cache\ folder, compile a sample program to the app\ folder, and then operate that program. If there are any failure messages, correct for them until this command succeeds. See for additional information. Use your text editor to modify VCrayApp.bat for your own project instead of the sample. Only two changes are required, as specified in that file. MANIFEST OF VCrayApp-0.0.0.zip NOTICE.txt 1.0.2 2,056 byte 2023-01-02T22:09Z version applicable NOTICE for VCrayApp-0.0.0.zip and its content VCrayApp-0.0.0.txt 0.0.7 11,862 byte 2023-01-07T20:49 clearsigned version This description file on organization of the archive and use of its materials. VCrayApp.bat 0.0.18 10,901 byte 2022-12-31T20:30Z version Script that, when run, will confirm VC/C++ command-prompt settings and perform compilation of a raylib cache\ and project source codes, to deliver a compiled result in app\. .vscode\ provided for use of Visual Studio Code with .vscode.txt a .txt project synopsis and manifest for c_cpp_properties.json the .vscode folder app\ .gitignore used to suppress compiled binaries from source control app.txt synopsis and manifest for the app\ folder cache\ .gitignore used to suppress intermediate files from source control cache.txt synopsis and manifest for the cache\ folder rayConfirm.c sample program used to confirm successful operation raylibCode.3.7.0.opt options file for compiling raylib-3.7.0 components raylibCode.4.0.0.opt options file for compiling raylib-4.0.0 components raylibCode.opt options file that is used (raylib-4.0.0 default) raylibVars.opt additional parameters used in compiling the cache rayLinking.opt options file for linking to make the .exe file VCoptions.opt options file for both cache\ and project code compilation src\ src.txt synopsis and manifest for the src\ folder The supplied text files provide further descriptions and explanations for usage and customization of each folder. - ----|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* Copyright 2021-2023 Dennis E. Hamilton Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. - ----|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* ATTRIBUTION Hamilton, Dennis E. Building raylib Apps with VS Developer Command Prompt. nfoTools file VCrayApp-0.0.0.txt version 0.0.7 dated 2023-01-07 available on the internet as a version of - ----|----1----|----2----|----3----|----4----|----5----|----6----|----7----|--* 0.0.7 2023-01-07T20:44Z Clearsigned version 0.0.6 2023-01-02T22:36Z Updating manifested time stamps 0.0.5 2022-12-31T20:12Z Review and Touch-ups 0.0.4 2022-10-26T17:34Z Near-final draft before signing 0.0.3 2022-08-24T17:28Z Provisional draft for Alpha release 0.0.2 2022-07-13T17:24Z Draft Editing of Expanded Boilerplate. 0.0.1 2022-06-07T22:27Z Include boilerplate from VCbind-0.1.0 0.0.0 2021-10-09T00:46Z Placeholder draft ***** end of VCrayApp-0.0.0.txt ***** -----BEGIN PGP SIGNATURE----- iQFGBAEBCAAwFiEEBNBDIpebhN4QdwM0+W6J/9RWYooFAmO52tQSHG9yY21pZEBh cGFjaGUub3JnAAoJEPluif/UVmKKtW4H/jCpyZKIiZ9N++UiTeOHPEbFfyPQZUkU Y2hAvWrxahx1OZlNabrO9hioDzuBwcf7boRcXmwdAaT6Ownkf+2nxc39Wex3JdDe cqLkgKS9HMNvXAYML0BA2baGOv109Kw12t9VreAx/k0rL6EVmvCNJGj/+A7h8K6h ofahN85h9gfXMBrVzgDPgfMWGNeLFwu8celeJg4jazK21/T4OkTg6FZPZdGD6lNZ ssqOdV1RO7mZu6Pj1rJnw48hvryI0ZFoFWm6uJjZnlK7Hv5gIpHF/QnIEEqwyTsU JooGU41ENTj2VrYxvn+99K69OF8Id0Ofx5WfWqmsb7W2oYlOGxvZMZc= =ixB8 -----END PGP SIGNATURE-----