대상 플랫폼 및 환경 설정에 맞게 자신의 플러그의 빌드가 끝나면 Audiokinetic 런처를 통한 설치를 위한 패키지가 필요할 수 있습니다. 여기에는 두 단계 과정이 있습니다.
- 각 대상 플랫폼 패키지와 함께 특수한 Common (공통) 플랫폼도 패키지합니다. 패키지 스크립트는 Wwise 설치에서 필요한 모든 파일을 자동으로 불러옵니다.
- bundle.json 파일을 생성합니다. 번들 생성 스크립트는 플러그인 디렉터리에서 이전에 패키지된 아카이브를 자동으로 불러옵니다.
예를 들어 다음 명령줄을 실행해 Common, Documentation, Windows_vc160 및 Authoring 플랫폼을 패키지합니다.
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Common --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Documentation --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Windows_vc160 --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Authoring --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" generate-bundle --version=XXXX.X.X.X
version
인자는 year.major.minor.build
형태의 Wwise 버전 번호 양식을 사용합니다.
| 참고: 플러그인의 Documentation (문서) 부분은 선택 사항입니다. |
플러그인의 추가 파일 패키지하기
–additional-artifacts 플래그나 –additional-artifacts-file 플래그를 사용해 모든 플랫폼에 대해 추가 파일을 패키지할 수 있습니다.
–additional-artifacts-file 플래그를 사용할 경우, 패키지할 추가 파일들의 경로 목록이 있는 JSON 파일이 있어야 합니다. 대상 경로는 반드시 자신의 Wwise 설치 루트에 대해 상대적이여야 하며, 소스 경로는 플러그인 디렉터리 루트에 대해 상대적이여야 합니다.
예를 들어, 다음은 앞에서 언급한 섹션의 명령줄입니다. Windows_vc160 및 Authoring 플랫폼으로 추가 DLL 파일을 패키지하도록 업데이트됩니다.
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Common --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Documentation --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Windows_vc160 --version=XXXX.X.X.X --additional-artifacts-file=additional_artifacts.json
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Authoring --version=XXXX.X.X.X --additional-artifacts-file=additional_artifacts.json
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" generate-bundle --version=XXXX.X.X.X
이전 예제에서 사용한 additional_artifacts.json 파일은 플러그인 디렉터리 루트에 있으며, 내용은 다음과 같습니다 (lib/Debug/library.dll
과 lib/Release/library.dll
이 해당 플러그인 디렉터리에 존재할 경우).
{
"Authoring": [
{
"Authoring/x64/Release/bin/Plugins": ["lib/Release/library.dll"]
}
],
"Windows_vc160": [
{
"SDK/Win32_vc160/Debug/bin": ["/lib/Debug/library.dll"],
"SDK/Win32_vc160/Release/bin": ["/lib/Release/library.dll"],
"SDK/x64_vc160/Debug/bin": ["lib/Debug/library.dll"],
"SDK/x64_vc160/Release/bin": ["lib/Release/library.dll"]
}
],
}
–additional-artifacts 플래그도 비슷하게 동작하지만, 한 번에 한 경로만 허용합니다 (따라서 두 개 이상의 추가 파일을 패키지할 경우 플래그를 여러번 지정해줘야 함).
마지막으로, 이 동일한 additional_artifacts.json 파일을 사용해 프로젝트 디렉터리에 있는 다른 파일들을 패키지할 수도 있습니다. 이 때는, 경로 대신 대상 -> 소스 항목을 지정하세요. 앞서 언급했듯이 대상 경로는 Wwise 설치 루트에 상대적이어야 하며, 소스 경로는 플러그인 디렉터리 루트에 대해 상대적이어야 합니다. 다음은 앞에서 다룬 Authoring 플랫폼 예제의 또 다른 버전으로, 여기서는 Factory Assets 와 Help 파일을 패키지합니다.
{
"Authoring": [
{
"Authoring/x64/Release/bin/Plugins": ["lib/Release/library.dll"]
"Authoring/Help/<PluginName>": ["Help/*.pdf"],
"Authoring/Data/Factory Assets/<PluginName>": [
"FactoryAssets/*.wproj",
"FactoryAssets/*.xml"
]
}
],
"Windows_vc160": [
{
"SDK/Win32_vc160/Debug/bin": ["/lib/Debug/library.dll"],
"SDK/Win32_vc160/Release/bin": ["/lib/Release/library.dll"],
"SDK/x64_vc160/Debug/bin": ["lib/Debug/library.dll"],
"SDK/x64_vc160/Release/bin": ["lib/Release/library.dll"]
}
],
}
위에 제시된 추가 결함 파일을 사용하면 프로젝트 루트의 파일들을 Wwise 설치 루트로 쉽게 복사할 수 있습니다. 대상 -> 소스 항목은 –copy-artifacts 플래그를 사용해 복사할 수 있습니다. 이 옵션은 모든 패키징을 건너뛰고 파일만 복사합니다.
다음 섹션: 플러그인의 Factory Asset 만들기