summaryrefslogtreecommitdiff
path: root/README
blob: 8554ea23527c05b1aa11f2001c907c30c2fc6482 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
                                    exe2app
                                    -------

exe2app.bash is a script to create a macOS Application bundle from a
passed executable and icon file and other information.

It depends on the tools makeicns and dylibbundler.  Both are available on
Brew.  If they don't exist the script still completes but there will be no
icons and if the executable depends on dynamic libs it probably won't work.

usage:

exe2app.bash -x <executable path>
             -i <icon path>
             -o <created app path>
             -v <version string>
             -n <bundle identifier>
             -c <creator code>
             -p <copyright string>
             -m <minimum version of macOS supported>

<executable path>
        The path to the executable to run as the app.

<icon path>
        The path to the image to use as an icon.  makeicns is used to generate
        the icons, so anything that can understand should work.

<created app path>
        The name of the generated app.  The app will be named as the basename
        of this path.  ".app" will be added to this in the generated app so
        shouldn't be supplied.

<version string>
        The version string to put in the plist file.

<bundle identifier>
        The bundle identifier.  This string must be a uniform type identifier
        (UTI) that contains only alphanumeric (A-Z,a-z,0-9), hyphen (-), and
        period (.) characters. The string should also be in reverse-DNS format.
        For example "com.yourdomain.appname".

<creator code>
        A 4-character string unique to the bundle.  Quite how you know it's
        unique I don't know.

<copyright string>
        The copyright string for the app.

<minimum version>
        The minimum version of macOS supported.