[installer_PRD] IN-0003: Installer Packaging

[natural-law]

I have a question about:

• The Mac version could be either a .pkg or a .dmg file, but avoid putting a .pkg inside a .dmg since it is redundant.

Now I'm using .pkg in .dmg. Because .pkg is for installing step by step. Also it's for setup environment variables after installing. The other side, .pkg is a folder in fact. So I put the .pkg into a .dmg for easy downloading.

[natural-law]

@ricardoquesada , I found the installer of python is like this format. It's a .dmg after downloaded. And a .mpkg is in the .dmg for installing.

[ricardoquesada]

.pkg could be either a file or folder. It seems that the Cocos Engine pkg is a folder, but the Cocos Studio pkg is a file.

$ file Cocos\ Studio/Cocos\ Studio.pkg
Cocos Studio/Cocos Studio.pkg: xar archive - version 1

$ file Cocos\ Engine/Cocos\ Engine.pkg/
Cocos Engine/Cocos Engine.pkg/: directory

For simplicity, our .pkg should be a file. Other projects are using only a pkg like mono-runtime: http://www.mono-project.com/download/

[natural-law]

@ricardoquesada If .pkg can be generated as a file. I agree with that avoid putting a .pkg inside a .dmg.

But I'm sorry for one thing missed. I will use .mpkg instead of .pkg. Because the installing process contains optional steps (Installing the source code).

I will try to generate a .mpkg as a file. Thanks for your opinion.

[natural-law]

@ricardoquesada , I have done some research about the Mac Installer. Now I can generate a .pkg file (not a folder) with optional step by PackageMaker.

But there is another problem : I can't use custom icon for the installer. So which one do you prefer?

PS: The optional step is not obvious in the standard Mac Installer UI. The UI will looks like this:

[ricardoquesada]

I'm not worried about having a custom icon for the installer. The default icon is Ok.

Regarding the customize, I think it is Ok.