개발참고자료 | 아이군의 블로그

젠킨스는 CI(Continuous Integration) 툴중에 아마도 가장 유명한 CI툴이지 않을까 생각되는 오픈소스 프로젝트입니다. 빌드시에 사용할 수 있는 수백가지가 넘는 플러그인을 제공하고 있으며 대부분의 프로젝트를 자동화 할 수 있을 정도의 확장성과 배포 기능까지 갖추고 있습니다.

Xcode 프로젝트등의 빌드를 수행하기 위해서는 Jenkins 를 맥에서 구동하는 것이 필수일 것입니다. 이번에는 맥에서 Jenkins를 설치하여 구동하는 과정까지 기록을 해보려고 합니다. 복잡한 방법을 사용할것 없이 Homebrew를 사용하면 Jenkins를 손쉽게 설치할 수 있습니다. (이미 설치되어있는 분은 패스하세요~)

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

위의 명령을 사용하여 간편하게 Homebrew를 설치할 수 있습니다. 이제 젠킨스를 설치해 보겠습니다.

$ brew install jenkins
==> Using the sandbox
==> Downloading http://mirrors.jenkins-ci.org/war/2.24/jenkins.war
Already downloaded: /Users/dennis/Library/Caches/Homebrew/jenkins-2.24.war
==> jar xvf jenkins.war
==> Caveats
Note: When using launchctl the port will be 8080.

To have launchd start jenkins now and restart at login:
  brew services start jenkins
Or, if you don't want/need a background service you can just run:
  jenkins
==> Summary
🍺  /usr/local/Cellar/jenkins/2.24: 7 files, 67.5M, built in 3 seconds

위와 같이 명령어 한줄로 간단하게 젠킨스를 설치할 수 있습니다. 젠킨스를 백그라운드 서비스로 구동하려면 마찬가지로 간단하게 다음의 명령어 한줄이면 등록이 됩니다.

$ brew services start jenkins
==> Successfully started `jenkins` (label: homebrew.mxcl.jenkins)

나중에 젠킨스를 삭제하려면 다음과 같은 명령을 사용하면 됩니다. (지금 하는것 아님!)

$ brew services stop jenkins
$ brew remove jenkins

이제 젠킨스를 실행했으니 웹사이트에 접속을 해보겠습니다. 로컬 컴퓨터라면 http://localhost:8080에 접속하시면 됩니다.

위와 같은 화면이 나오게 됩니다. 설치과정에서 외부에서 접속해서 이래저래 하는것을 막기 위한 조치인듯 하네요. 현재 젠킨스를 설치하고 있는 계정의 홈디렉토리에 초기 비밀번호를 기록해 두었으니 그것을 읽어서 그 값을 입력하라고 합니다.

$ cat /Users/dennis/.jenkins/secrets/initialAdminPassword
1c6002e332504fe3b076dbe598834170

이런식으로 읽어보시면 해당 키 값을 읽을 수 있습니다. 이것을 입력해주면 다음으로 진행이 됩니다.

젠킨스를 어떻게 설치할지 결정할 수 있습니다. 어떤 추가기능을 설치할것인지 결정하는 부분인데요 왼쪽은 일반적으로 사용되는 플러그인들을 설치하는것이고 오른쪽은 하나하나 선택하여 설치할 수 있는 방법을 제공합니다. 필요한 추가적인 플러그인은 나중에 설치하기로 하고 우선 왼쪽의 선택지로 진행하겠습니다.

이런식으로 필요한 플러그인들을 자동으로 설치하기 시작합니다. 간혹 네트워크 환경에 따라 설치가 되지 않는 경우가 있는데 이경우 네트워크 환경을 점검하시기 바랍니다.

저같은 경우에는 회사에서는 Jar 파일 다운로드에 방화벽상의 제약이 있어서 설치가 제대로 되지 않는 문제가 있었습니다.

설치가 된 이후에는 위와 같은 관리자 계정을 만드는 창이 나옵니다. 여기서는 적절히 자신에게 맞는 정보를 입력하여 관리자 계정을 만들어 주시면 됩니다.

설치가 완료되었습니다. 정말 간단하고 쉽네요. 이제 만들어진 관리자 계정으로 로그인하여 진입해보겠습니다.

젠킨스를 정상적으로 설치하였고 관리자 계정을 만들어서 로그인하는것에 성공하였습니다. 프로젝트 빌드하는 방법에 대해서는 또 다른 글을 올리도록 하겠습니다.

현재 출시 되어있는 수많은 모바일 게임들을 살펴 보면 홍보를 목적으로 하는 쿠폰 시스템을 차용하고 있는것을 볼 수 있습니다. 이러한 쿠폰은 개발사에서 직접 발행한 문자/숫자로 이루어진 형태로 이루어져 있는 경우가 많으며 올아니 또는 오프라인의 실물 쿠폰을 만들어서 유저에게 뿌리고 있습니다. 가령 프렌즈팝의 경우 다음과 같은 모습의 오프라인 쿠폰이 있습니다.

위의 쿠폰의 경우에는 이용방법을 읽어보면 “구글 플레이 혹은 애플 앱스토어에서” 라는 언급이 되어있습니다. 즉 이 쿠폰을 구글플레이/앱스토어에서 다운받은 프렌즈팝 게임에 사용할 수 있는다. 정도로 이해할수가 있습니다. 하지만 백발백중의 오프라인 쿠폰에는 다음과 같은 언급이 있습니다.

“안드로이드 OS에서만 쿠폰을 입력할 수 있습니다”라는 부분이 중요합니다. 실제로 백발백중의 쿠폰을 사용하기 위해서 iOS판을 실행하여 설정 메뉴에 들어가 보면 다음과 같은 쿠폰 버튼이 존재하지 않습니다.

iOS에서는 이 쿠폰을 사용할 수 없다는 이야기인데요 이는 단순히 개발자가 귀찮아서라는 이유는 아닐것입니다. 실제로 이렇게 쿠폰 시스템을 갖춘 게임/앱을 애플에 심사를 넣어보면 다음과 같은 리젝을 먹게 됩니다.

11.1

We found your app inappropriately unlocks or enables additional functionality with mechanisms other than the App Store, which is not in compliance with the App Store Review Guidelines.

Specifically, we noticed that the app utilizes codes to unlock features.

애플의 [리뷰 가이드라인]을 확인해 보면 11.1 항목에 다음과 같은 내용이 있습니다.

11. Purchasing and currencies

11.1
Apps that unlock or enable additional features or functionality with mechanisms other than the App Store will be rejected

앱스토어 이외의 어떤 매커니즘을 통해서 어떤 추가적인 기능이 언락되거나 활성화된다면 리젝될것이다..라는 무서운 언급인데요. 내가 만든 앱이지만 내 맘대로 하지도 못하게 하는 애플입니다. 결과적으로 앱스토어가 제공하는 기능들(예: In-App Purchase 등)을 제외한 모든 형태의 개발자가 개인적으로 구현한 유저에게 이익을 주는 행위는 리젝 사유입니다.

결론적으로 개발사가 임의로 구현한 쿠폰 시스템(예: 쿠폰 번호를 입력하면 다이아 500개 지급)은 애플에서 허용하지 않습니다. 하지만 iOS용 게임임에도 불구하고 쿠폰 시스템을 사용할 수 있는 게임을 볼 수 있습니다. 지금 부터 그런것을 어떻게 구현하면 될지 더 나아가 좀 더 나은 방법은 없을지 정리해 보겠습니다.

방법1. 서버에서 쿠폰 메뉴를 보여줄지 말지 결정하기

아마 이 방법이 많은 게임사들이 iOS에서 쿠폰 시스템을 구현하기 위해서 사용하는 방법이 아닐까 생각합니다. 게임뿐만 아니라 많은 앱들이 애플의 심사를 통과하는데 불필요한 화면들을 심사 기간동안 감추는 방법을 사용하고 있으며 나중에라도 애플이 걸리게 되면 좋은 일은 없겠지만 그럼에도 불구하고 많이들 사용하고 있는 방법입니다.

이 방법은 서버상에서 “심사” 플래그를 두고, 클라이언트는 실행되는 시점에 이 심사 플래그 값을 서버로부터 읽어갑니다. 심사 플래그가 참일 경우 클라이언트는 심사에 불리한 모든 기능을 보여주지 않는식으로 동작을 하게 합니다.

이후에 “Ready for Sale” 로 상태를 변경하면서 심사 플래그를 거짓으로 변경하면 일반 유저들은 온전히 모든 컨텐츠를 즐길 수 있게 됩니다.

방법2. 커스텀 스킴을 통해 앱 외부에서 쿠폰 정보를 넘겨받기

해외의 포럼글을 읽다가 매우 그럴싸한 글을 하나 발견하였습니다. 위에 언급한 서버에서 플래그를 두어서 쿠폰 메뉴를 보였다가 감추었다가 하는 방식은 애플의 불시 검문에 발각될(?) 가능성이 있습니다. 하지만 이러한 플래그를 두지 않고 앱 바깥에서 쿠폰지급을 처리한다면 문제가 다릅니다. 앱 내부에 쿠폰을 지급처리하는 어떠한 메뉴나 기능의 요소가 존재하지 않으며 바깥에서 지급처리를 하게 됨으로 애플의 불시 앱 검문에서도 문제가 되지 않습니다.

하지만 여기서도 생각해볼 문제가 하나 있습니다. 검증된 유저에게 한번의 지급만을 해야 한다면, 앱 외부에서 어떻게 해당 유저의 인증 여부를 명확하게 판단할 수 있을까요? 대부분의 인증 시스템의 구현은 앱 내부에서 구현되어있습니다. 하지만 이 부분은 앱 외부에서 쿠폰 정보를 들고 게임으로 넘어가는 방법으로 구현할 수 있습니다.

먼저 쿠폰 입력이 가능한 프로모션 페이지를 개발합니다. 이곳에는 일반적으로 게임 내부에서 볼 수 있는 쿠폰을 입력할 수 있는 폼이 존재하게 됩니다.
유저에게 전달될 쿠폰에 “구글플레이/앱스토어에서 XXX 게임을 검색해서 설치 후 설정 – 쿠폰 메뉴에서 다음의 코드를 입력” 이 문구 대신에 단순히 프로모션 페이지 URL에 접속하여 사용하라고만 안내합니다.
유저가 쿠폰입력 사이트에 접속하여 쿠폰을 입력한 뒤 “확인” 버튼을 누르면 앱이 설치되어있다면 해당 쿠폰 정보를 들고 앱을 실행하고 앱이 설치되어있지 않다면 앱 다운로드 URL로 이동시킵니다.
앱이 실행될 때 쿠폰 정보가 커스텀 스킴을 통해 입력되었다면 곧바로 지급 처리를 하고 팝업을 띄워 정상적으로 쿠폰 지급이 되었음을 알립니다.

대충 서버에서 쿠폰 페이지를 만든다면 예제는 다음과 같은 형태를 가질 것입니다.

<html>
<head>
  <script type="text/javascript">
    function formSubmit() {
		var couponValue = document.forms['couponForm']['coupon'].value;
		document.location = 'myCouponApp://?coupon=' + couponValue;
	}
  </script>
</head>
<body>
  <form name="couponForm" onsubmit="formSubmit(); return false;">
    쿠폰: <input type="text" name="coupon"/>
	<input type="submit" value="확인" />
  </form>
</body>
</html>

그리고 iOS의 경우 커스텀 스킴에서 저렇게 넘겨 받은 coupon의 값을 읽어서 아이템 지급 처리에 사용합니다. 다음의 메소드는 AppDelegate.m 파일에 추가해야할 부분입니다.

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url
  options:(NSDictionary<NSString *,id> *)options {

    NSString *query = [url query];
    NSArray *queryComponents = [query componentsSeparatedByString:@"&"];
    
    for (NSString *component in queryComponents) {
        NSArray *keyValue = [component componentsSeparatedByString:@"="];
        if ([[keyValue objectAtIndex:0] isEqualToString:@"coupon"]) {
            NSString *couponValue = [keyValue objectAtIndex:1];
            NSLog(@"입력된 쿠폰번호 : %@", couponValue);
            
            // 이곳에서 사용자 정보를 가져와 아이템을 지급 처리 합니다.
            // 처리 결과를 팝업 형태로 띄워서 알려줍니다.
        }
    }
    
    return YES;
}

이곳의 처리는 앱 내부에서 진입하여 처리되는 부분이 아니며 앱의 외부를 통해 접근할 때 실행되는 로직의 영역입니다. 하지만 앱 내부이기 때문에 기 로그인되어있는 유저의 정보에도 접근이 가능합니다. 즉 “쿠폰정보”와 “사용자 정보” 둘 모두가 있기 때문에 정상적으로 상품 지급의 처리를 할 수 있습니다. 물론 중복 처리를 막는 처리도 할 수 있겠지요.

참고 :

https://forums.coronalabs.com/topic/37264-rejected-by-apple-cause-of-promo-code-custom-solution/
https://forums.coronalabs.com/topic/37264-rejected-by-apple-cause-of-promo-code-custom-solution/

아이군의 블로그

배움에 망설이는 그순간 당신은 2류

Category Archives: 개발참고자료

Mac에 Homebrew를 사용하여 Jenkins 설치하기

iOS 쿠폰 시스템 구현 방법에 대한 고찰

방법1. 서버에서 쿠폰 메뉴를 보여줄지 말지 결정하기

방법2. 커스텀 스킴을 통해 앱 외부에서 쿠폰 정보를 넘겨받기