Skip to content
This repository has been archived by the owner on Apr 5, 2024. It is now read-only.

젠킨스에서 실행하는 유니티 빌드 스크립트입니다.

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.meta
Notifications You must be signed in to change notification settings

KorStrix/Unity_JenkinsBuilder

Repository files navigation

이 저장소는 관리되지 않습니다.

https://github.com/unity-korea-community/unity-builder

1. 젠킨스 빌더 프로젝트입니다.

젠킨스에서 실행하는 유니티 빌드 스크립트 패키지입니다.

기능

  • Unity Editor 내부/외부(커맨드라인)에서 ConfigFile을 통해 Platform별로 빌드

2. 왜 만들었나요?

커맨드라인을 통해 Unity Build를 할경우 이것저것 세팅할게 많습니다.

이 세팅들을 파일(=Config File)에 담은 후 경로만 넘겨주는 식으로 빌드하기 위해서 만들었습니다.

(Config 파일 링크)

3. 어떻게 설치하나요?

링크를 참고바랍니다.

Unity Editor 상단탭/Tools/Build에 메뉴가 뜨면 설치 성공!


4. 빌드 테스트

4-1. Build Config 생성 및 Editor에서 바로 빌드 테스트

  1. 유니티 에디터의 상단 탭 - Tools/Strix/Jenkins Build/Create Build Config Exmaple FileConfigFile을 생성합니다.
  2. Config FileJson 형식으로 이루어져 있으며, 각 항목당 설명은 스크립트에 주석(링크)으로 달았습니다. 이를 참고하며 Config File을 프로젝트에 맞게 수정합니다.
  3. 수정 완료 후 Tools/Strix/Jenkins Build/Show Jenkins Builder Window를 통해 윈도우를 엽니다.
  4. 아까 작성한 Config File Path를 설정 후 빌드 파일을 어디에 생성할지 세팅합니다.
  5. Android or IOS Build를 합니다.
  • 빌드 하기 전 주의사항 ) 프로젝트의 Platform이 해당 Platform인지 확인합니다.
  • AOS는 APK를 바로 빌드할 수 있지만, IOS의 경우 유니티에선 Xcode Project로 Export밖에 못합니다.
  1. APK or XCode Project가 세팅한 Output path에 나오면 성공!

4-2. 젠킨스 - 안드로이드 빌드 테스트

빌드하기 전 BuildConfig/AndroidSetting을 세팅하세요.

안드로이드는 크게 어렵지 않기 때문에 자세한 설명을 생략합니다.

빌드 방법

  1. 젠킨스 프로젝트를 생성 합니다.
  • 젠킨스 프로젝트 생성 관련 내용은 여기서 다루지 않습니다.
  1. 젠킨스 프로젝트 구성 - Build 항목에 Invoke Unity3D Editor 항목이 있습니다. 여기서 Editor command line arguments를 수정할 예정입니다.
  • 이 항목에는 Unity Default CommandLine과 이 프로젝트의 CommandLine을 같이 쓰며 CommandLine을 통해 "어떻게" 유니티를 실행시키고, 이 프로젝트의 빌드 스크립트를 "어떻게" 실행하는지를 세팅하는 곳입니다.
  • 유니티 에디터의 커맨드라인 중 -quit -batchmode -logFile log.txt를 넣습니다. 이에 대한 설명은 유니티 메뉴얼(링크)를 참고합니다.
  • 하단의 라인도 연달아 삽입합니다.
-executeMethod Jenkins.Builder.Build_Android -config_path YOUR_CONFIG_PATH.json -output_path ${JENKINS_HOME}/jobs/${JOB_NAME}/builds/${BUILD_NUMBER}/archive

여기서 YOUR_CONFIG_PATH에 Build Config 파일의 경로를 세팅합니다. 다른 커맨드 라인을 보고싶으시면 스크립트(링크)를 참고바랍니다.

  • ${JENKINS_HOME}, ${JOB_NAME}, ${BUILD_NUMBER}의 경우 Jenkins 환경변수입니다.
  1. Build를 한 뒤 Archive에 APK파일이 있으면 성공!

4-3. 젠킨스 - IOS 빌드 테스트

빌드하기 전 BuildConfig/iOSSetting을 세팅하세요.

주의사항

IOS 빌드를 위해선 MAC OS의 PC와 Apple 개발자 계정이 필요합니다.

개요

안드로이드의 경우 PC -> APK 추출 -> 선택에 따라 -> APK 스토어 업로드까지 크게 어렵지는 않으나,

IOS의 경우 ipa를 공유하려면 PC -> XCode Project -> ipa 추출 -> Appstore Connect 업로드까지 해아 하며, PC -> XCode Project 과정에서 ipa -> Appstore Connect 업로드에 필요한 plist(property list) 등을 함께 Xcode Project에 담아야 합니다. 이것은 Config File로 작업할 수 있습니다.

젠킨스에 IOS Build 플러그인이 있음에도 불구하고 배치파일로 뺀 이유는 세팅 간소화 및 범용성을 위해서입니다. (플러그인에 세팅해야 할 변수가 많음, 젠킨스가 아닌 환경에서도 쓸 수 있게끔)

여기서 IOS 빌드 테스트 항목은 PC -> XCode Project -> ipa 추출 및 Appstore Connect 업로드까지 테스트합니다.

Appstore Connect 링크 https://appstoreconnect.apple.com/

빌드 방법

  1. 젠킨스 프로젝트 생성 후 프로젝트 구성으로 갑니다.
  2. Build에 Execute Shell 작업을 추가하고 하단의 내용을 적습니다.
# 폴더 내 모든 걸 비우기
rm -r ${WORKSPACE}/Build/
  1. BuildInvoke Unity3D Editor/Editor command line arguments에 하단의 내용을 적습니다.
-quit -batchmode -executeMethod Jenkins.Builder.Build_IOS -config_path YOUR_CONFIG_PATH.json -output_path ${WORKSPACE} -filename Build -ios_version 1
  1. BuildExecute Shell 작업을 추가하고 하단의 내용을 적습니다.
# ipa Export
sh "ios_export_ipa.sh이 들어있는 경로" "${WORKSPACE}" "AppleTeamID"

여기서 AppleTeamID는 애플 계정에 있는 애플 팀 ID를 기입합니다. 팀 ID는 숫자와 대문자 영어로 이루어진 10개의 단어입니다. (2020.08 기준)

  1. Mac OS가 설치된 PC에서 XCode를 설치 후 Preference - AppleTeamID를 등록한 뒤 빌드를 합니다.
  2. Build를 한 뒤 AppleStore Connect 사이트에 세팅한 빌드번호의 빌드가 있으면 성공

About

젠킨스에서 실행하는 유니티 빌드 스크립트입니다.

Topics

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.meta

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published