icon안동민 개발노트

크로스 플랫폼 개발 고려사항


 언리얼 엔진 C++ 프로젝트를 여러 플랫폼에 동시에 개발하고 배포하는 것은 복잡하지만 중요한 작업입니다.

 이 절에서는 크로스 플랫폼 개발 시 고려해야 할 주요 사항들을 살펴보겠습니다.

플랫폼별 빌드 설정 및 최적화 전략

 각 플랫폼의 특성에 맞는 빌드 설정이 필요합니다.

// Build.cs
public class MyGameBuildSettings : ModuleRules
{
    public MyGameBuildSettings(ReadOnlyTargetRules Target) : base(Target)
    {
        if (Target.Platform == UnrealTargetPlatform.Windows)
        {
            // Windows 특화 설정
        }
        else if (Target.Platform == UnrealTargetPlatform.PS4)
        {
            // PS4 특화 설정
        }
        else if (Target.IsInPlatformGroup(UnrealPlatformGroup.Mobile))
        {
            // 모바일 플랫폼 공통 설정
        }
    }
}

하드웨어 특화 기능 활용

 플랫폼별 특수 하드웨어 기능을 활용하는 방법

##if PLATFORM_PS5
    // PS5 특화 기능 (예: 햅틱 피드백)
    void AMyPlayerController::EnableHapticFeedback()
    {
        // PS5 햅틱 피드백 API 호출
    }
##endif
 
##if PLATFORM_SWITCH
    // Nintendo Switch 특화 기능
    void AMyGameMode::EnableMotionControls()
    {
        // Switch 모션 컨트롤 API 호출
    }
##endif

플랫폼 간 일관된 사용자 경험 유지

 사용자 인터페이스를 플랫폼에 맞게 조정

UCLASS()
class UMyUserWidget : public UUserWidget
{
    GENERATED_BODY()
 
public:
    virtual void NativeConstruct() override
    {
        Super::NativeConstruct();
 
        ##if PLATFORM_DESKTOP
            SetDesktopLayout();
        ##elif PLATFORM_MOBILE
            SetMobileLayout();
        ##else
            SetDefaultLayout();
        ##endif
    }
 
private:
    void SetDesktopLayout();
    void SetMobileLayout();
    void SetDefaultLayout();
};

입력 처리의 플랫폼별 차이점 해결

 다양한 입력 방식을 통합 관리

UCLASS()
class UMyInputManager : public UObject
{
    GENERATED_BODY()
 
public:
    void ProcessInput(const FInputActionValue& Value)
    {
        ##if PLATFORM_DESKTOP
            ProcessDesktopInput(Value);
        ##elif PLATFORM_MOBILE
            ProcessMobileInput(Value);
        ##elif PLATFORM_XBOXONE || PLATFORM_PS4
            ProcessConsoleInput(Value);
        ##endif
    }
 
private:
    void ProcessDesktopInput(const FInputActionValue& Value);
    void ProcessMobileInput(const FInputActionValue& Value);
    void ProcessConsoleInput(const FInputActionValue& Value);
};

그래픽 설정의 동적 조정

 플랫폼 성능에 따른 그래픽 설정 자동 조정

UCLASS()
class UGraphicsSettingsManager : public UObject
{
    GENERATED_BODY()
 
public:
    void AutoAdjustGraphicsSettings()
    {
        FString PlatformName = UGameplayStatics::GetPlatformName();
        if (PlatformName == "Windows")
        {
            AdjustForPC();
        }
        else if (PlatformName == "IOS" || PlatformName == "Android")
        {
            AdjustForMobile();
        }
        // 기타 플랫폼 처리
    }
 
private:
    void AdjustForPC();
    void AdjustForMobile();
};

플랫폼별 특수 API 통합

 각 플랫폼의 고유 API를 통합

UCLASS()
class UPlatformIntegrationManager : public UObject
{
    GENERATED_BODY()
 
public:
    void InitializePlatformServices()
    {
        ##if PLATFORM_IOS
            InitializeIOSServices();
        ##elif PLATFORM_ANDROID
            InitializeAndroidServices();
        ##elif PLATFORM_XBOXONE
            InitializeXboxServices();
        ##endif
    }
 
private:
    void InitializeIOSServices();
    void InitializeAndroidServices();
    void InitializeXboxServices();
};

크로스 플레이 기능 구현

 플랫폼 간 크로스 플레이 지원

UCLASS()
class ACrossPlayGameMode : public AGameModeBase
{
    GENERATED_BODY()
 
public:
    virtual void PostLogin(APlayerController* NewPlayer) override
    {
        Super::PostLogin(NewPlayer);
 
        FString PlatformName = UGameplayStatics::GetPlatformName();
        AssignCrossPlatformID(NewPlayer, PlatformName);
    }
 
private:
    void AssignCrossPlatformID(APlayerController* Player, const FString& Platform);
};

플랫폼 간 세이브 데이터 동기화

 클라우드 저장소를 활용한 세이브 데이터 동기화

UCLASS()
class UCloudSaveManager : public UObject
{
    GENERATED_BODY()
 
public:
    void SyncSaveData()
    {
        ##if PLATFORM_XBOXONE
            SyncWithXboxLive();
        ##elif PLATFORM_PS4
            SyncWithPSN();
        ##else
            SyncWithCustomCloud();
        ##endif
    }
 
private:
    void SyncWithXboxLive();
    void SyncWithPSN();
    void SyncWithCustomCloud();
};

플랫폼별 인증 및 결제 시스템 통합

 다양한 플랫폼의 인증 및 결제 시스템 통합

UCLASS()
class UAuthAndPaymentManager : public UObject
{
    GENERATED_BODY()
 
public:
    void Authenticate()
    {
        ##if PLATFORM_IOS
            AuthenticateWithApple();
        ##elif PLATFORM_ANDROID
            AuthenticateWithGoogle();
        ##else
            AuthenticateWithCustomSystem();
        ##endif
    }
 
    void ProcessPayment(const FString& ProductID)
    {
        ##if PLATFORM_IOS
            ProcessApplePayment(ProductID);
        ##elif PLATFORM_ANDROID
            ProcessGooglePayment(ProductID);
        ##else
            ProcessCustomPayment(ProductID);
        ##endif
    }
 
private:
    void AuthenticateWithApple();
    void AuthenticateWithGoogle();
    void AuthenticateWithCustomSystem();
 
    void ProcessApplePayment(const FString& ProductID);
    void ProcessGooglePayment(const FString& ProductID);
    void ProcessCustomPayment(const FString& ProductID);
};

효율적인 크로스 플랫폼 개발 워크플로우 구축

  1. 공통 코드 베이스 유지
  2. 플랫폼 특화 코드 분리
  3. 자동화된 빌드 및 테스트 파이프라인 구축
// 자동화된 빌드 스크립트 예시 (Python)
import subprocess
 
def build_for_platform(platform):
    command = f"UnrealBuildTool.exe MyGame {platform} Development"
    subprocess.run(command, shell=True, check=True)
 
platforms = ["Win64", "PS4", "XboxOne", "Switch", "Android", "IOS"]
 
for platform in platforms:
    build_for_platform(platform)

테스트 및 QA 프로세스 최적화

  1. 자동화된 크로스 플랫폼 테스트 구현
  2. 플랫폼별 특화 테스트 케이스 작성
  3. CI/CD 파이프라인에 테스트 통합
UCLASS()
class UCrossPlatformTestSuite : public UObject
{
    GENERATED_BODY()
 
public:
    void RunAllTests()
    {
        RunCommonTests();
        
        ##if PLATFORM_DESKTOP
            RunDesktopTests();
        ##elif PLATFORM_MOBILE
            RunMobileTests();
        ##elif PLATFORM_CONSOLE
            RunConsoleTests();
        ##endif
    }
 
private:
    void RunCommonTests();
    void RunDesktopTests();
    void RunMobileTests();
    void RunConsoleTests();
};

다양한 플랫폼에 대한 동시 업데이트 관리

  1. 버전 관리 시스템 활용
  2. 플랫폼별 브랜치 관리
  3. 중앙 집중식 업데이트 배포 시스템 구축
UCLASS()
class UUpdateManager : public UObject
{
    GENERATED_BODY()
 
public:
    void CheckForUpdates()
    {
        FString PlatformName = UGameplayStatics::GetPlatformName();
        FString CurrentVersion = GetCurrentVersion();
 
        // 서버에서 최신 버전 정보 가져오기
        FString LatestVersion = GetLatestVersionFromServer(PlatformName);
 
        if (CurrentVersion != LatestVersion)
        {
            InitiateUpdate(PlatformName, LatestVersion);
        }
    }
 
private:
    FString GetCurrentVersion();
    FString GetLatestVersionFromServer(const FString& Platform);
    void InitiateUpdate(const FString& Platform, const FString& Version);
};

 크로스 플랫폼 개발은 복잡하지만 보상이 큰 작업입니다. 다양한 플랫폼에 동시에 개발하고 배포함으로써 더 넓은 사용자 기반에 접근할 수 있습니다. 그러나 이를 위해서는 많은 기술적 도전과 고려사항이 있습니다.

 플랫폼별 빌드 설정과 최적화는 각 플랫폼의 특성을 고려해야 합니다. 예를 들어, 모바일 플랫폼에서는 배터리 수명과 메모리 사용을 최적화해야 하고, 콘솔에서는 특정 하드웨어 기능을 최대한 활용해야 합니다.

 하드웨어 특화 기능을 활용할 때는 해당 기능이 없는 플랫폼에서도 게임이 정상적으로 작동할 수 있도록 대체 로직을 구현해야 합니다. 이는 일관된 사용자 경험을 유지하는 데 중요합니다.

 입력 처리는 플랫폼마다 크게 다를 수 있습니다. 터치 스크린, 게임패드, 키보드/마우스 등 다양한 입력 방식을 통합적으로 관리할 수 있는 시스템을 설계해야 합니다.

 그래픽 설정은 각 플랫폼의 성능에 맞게 동적으로 조정되어야 합니다. 자동 감지 및 조정 시스템을 구현하여 최적의 성능과 시각적 품질을 제공할 수 있습니다.

 크로스 플레이 기능 구현은 플레이어 베이스를 통합하고 게임의 수명을 연장할 수 있는 강력한 기능입니다. 그러나 이는 네트워크 코드의 복잡성을 증가시키므로 신중한 설계가 필요합니다.

 세이브 데이터 동기화, 인증 및 결제 시스템 통합은 플랫폼별 API와 서비스를 고려해야 합니다. 클라우드 기반의 통합 솔루션을 구축하면 이러한 복잡성을 관리하기 쉬워집니다.

 효율적인 개발 워크플로우를 구축하기 위해서는 공통 코드 베이스를 유지하면서 플랫폼 특화 코드를 명확히 분리해야 합니다. 자동화된 빌드 및 테스트 파이프라인은 개발 속도와 코드 품질을 향상시키는 데 큰 도움이 됩니다.

 QA 프로세스는 모든 지원 플랫폼을 포괄해야 합니다. 자동화된 테스트 스위트를 구축하고, 각 플랫폼의 특성을 고려한 특화 테스트 케이스를 작성해야 합니다.