Add help. Candidate for merging ?

This commit is contained in:
Antonin Décimo
2014-07-21 14:56:35 +02:00
parent 1370745417
commit 1dd938cb48
2 changed files with 45 additions and 3 deletions

View File

@@ -10,7 +10,7 @@ love-release.sh can be used to generate Love 2D game applications
and get over the fastidious zipping commands you had to do. and get over the fastidious zipping commands you had to do.
The script fully supports Windows, MacOS either on x86 or x64, The script fully supports Windows, MacOS either on x86 or x64,
and Debian packages. Debian and Android packages.
It needs an Internet connection to download Love files, It needs an Internet connection to download Love files,
and relies on `curl`, `zip` and `unzip` commands. and relies on `curl`, `zip` and `unzip` commands.
To set the default Love version to use, To set the default Love version to use,
@@ -28,6 +28,14 @@ to set the game icon on Windows.
`--help` Print this longer help `--help` Print this longer help
#### OPERATING SYSTEMS #### OPERATING SYSTEMS
`-a` Create an Android package.
In order to create an Android package, you must have installed the Android SDK.
See [Building LÖVE for Android](https://bitbucket.org/MartinFelis/love-android-sdl2/wiki/Building_L%C3%96VE_for_Android_-_Linux),
but there is no need to install the [LÖVE port to Android](https://bitbucket.org/MartinFelis/love-android-sdl2),
as the script will handle this by itself.
You also might want to provide more informations about it.
See the ANDROID section below.
`-d` Create a deb package. Aimed at Debian and Ubuntu derivatives. `-d` Create a deb package. Aimed at Debian and Ubuntu derivatives.
In order to create a Debian package, you must provide more informations about it. In order to create a Debian package, you must provide more informations about it.
See the DEBIAN section below. See the DEBIAN section below.
@@ -67,7 +75,17 @@ to set the game icon on Windows.
`--maintainer-email` Set the maintainers email. `--maintainer-email` Set the maintainers email.
`--maintainer-name` Set the maintainers name. The company name is used by default. `--maintainer-name` Set the maintainers name. The company name is used by default.
`--package-name` Set the name of the package and the command that will be used to launch your game. `--package-name` Set the name of the package and the command that will be used to launch your game.
By default, it is the name of your project converted to lowercase, with eventual spaces replaced by dashes. By default, it is the name of your project converted to lowercase,
with eventual spaces replaced by dashes.
`--version` Set the version of your package.
#### ANDROID
Note that every argument passed to the options should be alphanumerical,
with eventual underscores (i.e. [a-zA-Z0-9\_]), otherwise you'll get errors.
`--maintainer-name` Set the maintainers name. The company name is used by default.
It must be only alphanumerical characters, with eventual underscores.
`--package-name` Set the name of the package.
By default, it is the name of your project, with eventual spaces replaced by underscores.
`--version` Set the version of your package. `--version` Set the version of your package.
#### OTHERS #### OTHERS

View File

@@ -10,6 +10,7 @@ function short_help()
echo "Usage: love-release.sh [options...] [files...] echo "Usage: love-release.sh [options...] [files...]
Options: Options:
-h, --help Prints short or long help -h, --help Prints short or long help
-a Create an Android package
-d Create a deb package -d Create a deb package
-l Create a plain Love file -l Create a plain Love file
-m Create a MacOS application -m Create a MacOS application
@@ -40,7 +41,7 @@ can be used to generate Love 2D game applications
and get over the fastidious zipping commands you had to do. and get over the fastidious zipping commands you had to do.
.PP .PP
The script fully supports Windows, MacOS either on x86 or x64, The script fully supports Windows, MacOS either on x86 or x64,
and Debian packages. Debian and Android packages.
It needs an Internet connection to download Love files, It needs an Internet connection to download Love files,
and relies on \fBcurl\fR, \fBzip\fR and \fBunzip\fR commands. and relies on \fBcurl\fR, \fBzip\fR and \fBunzip\fR commands.
To set the default Love version to use, To set the default Love version to use,
@@ -61,6 +62,14 @@ Print a short help
Print this longer help Print this longer help
.SH OPERATING SYSTEMS .SH OPERATING SYSTEMS
.TP .TP
.B \-a
Create an Android package.
In order to create an Android package, you must have installed the Android SDK,
but there is no need to install the LÖVE port to Android,
as the script will handle this by itself.
You also might want to provide more informations about it.
See the ANDROID section below.
.TP
.B \-d .B \-d
Create a deb package. Aimed at Debian and Ubuntu derivatives. Create a deb package. Aimed at Debian and Ubuntu derivatives.
In order to create a Debian package, you must provide more informations about it. In order to create a Debian package, you must provide more informations about it.
@@ -126,6 +135,20 @@ with eventual spaces replaced by dashes.
.TP .TP
.B \-\-version \fIversion\fR .B \-\-version \fIversion\fR
Set the version of your package. Set the version of your package.
.SH ANDROID
Note that every argument passed to the options should be alphanumerical,
with eventual underscores (i.e. [a-zA-Z0-9_]), otherwise you'll get errors.
.TP
.B \-\-maintainer\-name \fIname\fR
Set the maintainers name. The company name is used by default.
It must be only alphanumerical characters, with eventual underscores.
.TP
.B \-\-package\-name \fIname\fR
Set the name of the package.
By default, it is the name of your project, with eventual spaces replaced by underscores.
.TP
.B \-\-version \fIversion\fR
Set the version of your package.
.SH OTHERS .SH OTHERS
.TP .TP
.B \-\-refresh .B \-\-refresh
@@ -779,6 +802,7 @@ if [ "$RELEASE_APK" = true ]; then
fi fi
MAINTAINER_USERNAME=${MAINTAINER_NAME// /_} MAINTAINER_USERNAME=${MAINTAINER_NAME// /_}
PACKAGE_NAME=${PACKAGE_NAME//-/_}
ACTIVITY=${PROJECT_NAME// /_}Activity ACTIVITY=${PROJECT_NAME// /_}Activity
ANDROID_VERSION=$(grep -Eo -m 1 "[0-9]+.[0-9]+.[0-9]+[a-z]*" "$LOVE_ANDROID_DIR"/AndroidManifest.xml) ANDROID_VERSION=$(grep -Eo -m 1 "[0-9]+.[0-9]+.[0-9]+[a-z]*" "$LOVE_ANDROID_DIR"/AndroidManifest.xml)
ANDROID_LOVE_VERSION=$(echo "$ANDROID_VERSION" | grep -Eo "[0-9]+.[0-9]+.[0-9]+") ANDROID_LOVE_VERSION=$(echo "$ANDROID_VERSION" | grep -Eo "[0-9]+.[0-9]+.[0-9]+")