Version:

1.0

Format:

Zip file

Dependencies:

None

Description

Development environment for re-building DLL files using modified C# sources.

Package content

1. Four Microsoft Visual Studio projects for building two BGDatabase DLL files (and optionally two BGLocalization DLL files)
2. Unity project with additional utility tools:
   1. Switch from DLL files to sources
   2. Switch from sources to DLL files, source packages are also updated
   3. Compile new DLL files (Windows only)
   4. Export packages

How to use

1. Download and unzip the content to your local disk
2. Open {ROOT}/Unity directory in Unity Editor.
3. Import BGDatabase or BGLocalization package
4. Select "Tools/Switch to source code" to unzip source packages with C# source files and disable DLL files by turning off platform compatibility to avoid the conflicts with source files
   
5. Make changes to C# source files
6. Build new DLL files
   1. If you use Windows, you can build new DLL files right inside Unity Editor by running "Tools/Compile". You need Microsoft Visual Studio installed and the path to devenv.exe file included to your PATH environment variable. You can check if everything set up correctly by running {ROOT}/Build/database.bat file from terminal (CMD.exe). The following output should be printed to the console
      
   2. If you use MACOS or Linux - open Visual Studio projects and build DLLs manually. Projects are located under {ROOT}/Build. After building DLL files - copy them to Unity project. Built DLL files are located under {ROOT}/Build/{ProjectName}/bin/Release. There are 2 BGDatabase DLLs (for Runtime and Editor assemblies) and if you use localization addon there are 2 additional BGLocalization DLL files
7. Switch back to DLL files by running "Tools/Switch to DLL". This task updates source code packages first, delete all C# source files and enable DLL files by setting platforms compatibility.
8. Use "Tools/Export packages" to export BGDatabase and optionally BGLocalization packages. Exported packages are located under {ROOT}/Packages folder

Releases