본문으로 건너뛰기

애플리케이션 (app)

🚀 추가된 버전 : SDKSDKv1.0.0 AndroidAndroidv1.0.0 iOSiOSv1.0.0
🔔 최신화 일자: 2025-07-14

개요​

app 네임스페이스는 앱의 이름, 버전, 패키지명 등 주요 정보를 조회하거나, 앱의 최초 실행 여부를 확인하는 기능들을 제공합니다.

메서드 목록​

메서드설명추가된 버전
checkFirstLaunch(callback)앱이 최초 실행인지 여부를 확인합니다.SDKSDKv1.4.0
getAppName()앱의 이름을 가져옵니다.SDKSDKv1.0.0
getAppKey()nachocode 플랫폼에서 발급한 앱의 고유 키를 반환합니다.SDKSDKv1.0.0
getCurrentAppVersion()현재 설치된 앱 버전을 반환합니다.SDKSDKv1.0.0
getPackageName()앱의 패키지명을 가져옵니다.SDKSDKv1.0.0

메서드 상세​

checkFirstLaunch(callback: (isFirstLaunch: boolean) => void): void​

설명​

앱이 최초 실행인지 여부를 확인합니다. 이를 통해 온보딩 화면을 최초 실행 시에만 표시하거나, 특정 설정을 처음 실행 시에만 적용하는 등의 로직을 구현할 수 있습니다.

매개변수​

이름타입필수 여부설명
callback(isFirstLaunch: boolean) => void✅true(최초 실행) 또는 false(기존 실행)를 전달 받는 콜백 함수

반환 값​

해당 메서드는 반환 값을 가지지 않으며, 결과는 callback을 통해 비동기적으로 제공됩니다.

사용 예제​

Nachocode.app.checkFirstLaunch(isFirstLaunch => {
  if (isFirstLaunch) {
    console.log('앱이 최초로 실행되었습니다.');
    // 온보딩 화면 또는 초기 설정 적용
  } else {
    console.log('앱이 이미 실행된 적이 있습니다.');
  }
});

getAppName(): string​

설명​

현재 앱의 이름을 반환합니다.
이 값은 nachocode 대시보드에서 설정한 앱 이름과 동일합니다.

반환 값​

타입설명
string앱의 이름을 반환합니다.

사용 예제​

const appName = Nachocode.app.getAppName();
console.log(`앱 이름: ${appName}`);

getAppKey(): string​

설명​

앱 프로젝트를 식별하는 고유 키를 반환합니다.
이 키는 nachocode 서비스에서 앱을 구별하는 데 사용됩니다.

반환 값​

타입설명
stringnachocode에서 발급한 앱의 고유 식별 키입니다.

사용 예제​

const appKey = Nachocode.app.getAppKey();
console.log(`앱 키: ${appKey}`); // ex. 'APP-XXXXXXX'

getCurrentAppVersion(): string​

설명​

사용자의 현재 디바이스에 설치된 앱의 버전을 반환합니다.
이 값은 사용자의 앱 업데이트 상태를 확인하는 용도로 사용할 수 있습니다.

반환 값​

타입설명
string설치된 앱의 버전 (예: "1.0.0")

사용 예제​

const appVersion = Nachocode.app.getCurrentAppVersion();
console.log(`현재 앱 버전: ${appVersion}`); // ex. "1.0.0"

getPackageName(): string​

설명​

현재 실행 중인 앱의 패키지명을 반환합니다.
패키지명은 앱의 고유 식별자로, 일반적으로 com.nachocode.example 형식으로 제공됩니다.

반환 값​

타입설명
string애플리케이션의 패키지명 (예: "com.nachocode.example")

사용 예제​

const packageName = Nachocode.app.getPackageName();
console.log(`패키지명: ${packageName}`); // ex. "com.nachocode.example"