Skip to content
/ dev Public
forked from Bearsampp/dev

📐 Neard Development Kit for everyone who wants to contribute!

License

Notifications You must be signed in to change notification settings

jwaisner/dev

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bearsampp Development Kit

Tag Become a sponsor Donate Paypal

About

This a sub-repo of Bearsampp project involving the Development Kit required for everyone who wants to contribute!
Issues must be reported on Bearsampp repository.

Requirements

OpenJDK

You need OpenJDK 11 that you can download here.
Extract the archive on your computer (eg. C:\jdk) and add the path to java.exe (eg. C:\jdk\bin) to your environment variable PATH.
To check if you have Java in your path, open a command prompt and type java -version :

openjdk version "11.0.2" 2019-01-15
OpenJDK Runtime Environment 18.9 (build 11.0.2+9)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.2+9, mixed mode)

Apache Ant

Apache Ant is used with the OpenJDK to build and package the portapp.
You need at least Apache Ant 1.10.5 that you can download on the Apache website.
Extract the archive on your computer (eg. C:\apache-ant) and add the path to ant.bat (eg. C:\apache-ant\bin) to your environment variable PATH.
To check if you have Apache Ant in your path, open a command prompt and type ant -version :

Apache Ant(TM) version 1.10.5 compiled on July 10 2018

Bear's Instructions...


Configuration

Fork and clone the module of your choice. Clone dev in the parent folder of the module. Create a new pull request with your work.

For example :

cd C:\work\
git clone --recursive https://github.com/bearsampp/module-adminer.git
git clone --recursive https://github.com/bearsampp/dev.git
cd module-adminer\

Directory structure example :

[-] dev
 | [-] build
 |  |  | build-commons.xml 
[-] bearsampp-{bin|app|tool}-{name}
 |  | build.xml

Increment the build.release in the build.properties file. ( check previous version for proper r# ) If you want you can change the build.path in the build-commons.properties file By default it will be in the same folder tree as your current module.

If the folder does not exist it will be created during build time.

# The build path (was default C:/bearsampp-build)
build.path = ${project.basedir}/../bearsampp-build

image

There is currently an issue where you have put the new release ( such as https://github.com/bearsampp/modules-untouched/releases/tag/git-2.34.0 ) into git and THEN modify the corresponding *.properties file pointing to the new release.

There has to be a better way to do this...

Not doing this step will prevent you from creating the ant release. I spent hours trying to figure this out. I think a better ant script could take this into consideration automatically. but idk how to build such a thing.


Open a command prompt in your module folder and run the ant builder with "ant release"

Create an issue on my bearsampp fork ( https://github.com/bearsampp/bearsampp/issues ) repository with your files requesting a release or create a release on your fork and create a pr.


TS vs NTS

After reviewing https://windows.php.net/download/ it appears TS ( thread safe ) builds are whats desired.

License

LGPL-3.0. See LICENSE for more details.

About

📐 Neard Development Kit for everyone who wants to contribute!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%