태그 보관물: android

Android 15 대응 시 앱 화면이 겹치는 문제 해결

개요

구글의 정책에 따라 앱을 업데이트 하려면 최신 Android 출시로 부터 1년 이내여야 합니다. 기존 앱이 Android 14를 타겟팅하고 있었고 단순히 버전만 바꾸어서 확인해 보니 문제가 있었습니다. 이것을 해결하는 방법을 알아보도록 하겠습니다.

문제

Android 15 에뮬레이터에서 실행해 보면 크게 두 가지 문제가 있습니다. 하단 네비게이션 바가 광고를 덮는 문제, 앱 바가 가장 상단에 있지 않고 필드 하단에 나타나는 문제가 있습니다.

네비게이션 바가 하단 광고를 덮어버리는 문제
입력 항목이 앱바 아래가 아닌 위쪽에 나타나는 문제

해결

이것은 Android 15에서 추가된 Edge to Edge 와 관련된 문제입니다. 내용이 잘 정리되어 있으므로 앱 상황에 맞게 수정하시면 됩니다. 레이아웃이 완전히 깨지는 것을 처음 보면 많이 당황스러운데 차분히 잘 보면 어렵지 않게 해결하실 수 있으실 겁니다.

필자의 경우 다음과 같은 방법으로 해결했습니다.

첫 번째로 다음과 같이 레이아웃에 id를 추가했습니다.

<androidx.constraintlayout.widget.ConstraintLayout android:id="@+id/main_activity" ...

다음으로 소스 코드에 다음과 같은 코드를 onCreate 함수 setContentView 다음에 추가했습니다(java 기준).

ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main_activity), (v, insets) -> {
    Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
    return insets;
});

이렇게 하면 위에 언급한 두 가지 문제가 해결되어 정상적으로 보이는 것을 확인할 수 있습니다.

문제가 해결된 화면

Unreal Engine Android 패키징 파일 실기기에서 실행 시 Blank 화면 나타나는 문제 해결

개요

개발 중인 게임의 대략적인 컨셉을 잡고 대상 플랫폼인 안드로이드 기기에서 어떻게 보이는지 확인하고 싶었습니다. 개발 초기부터 확인을 하고 진행해야 문제가 없기 때문입니다. APK 파일로 패키징 후 실기기에서 확인해보니 오류는 발생하지 않는데 Blank 화면만 나타났습니다. 이 문제를 해결하는 방법을 알아보도록 하겠습니다.

문제 해결 방법

Unreal Engine 5.5.3 환경입니다. Project Settings > Platforms > Android > Build > Support Vulkan 체크 해제 후 패키징 하면 문제 없이 화면이 나타났습니다.

Support Vulkan 체크 해제
Support Vulkan 체크 해제

시도한 다른 방법

처음 문제를 접하고 시도해 본 방법들을 참고로 알려드립니다. 여러가지 자료를 찾아보던 중 이러한 문제 때문에 개발 자체가 중단되었다는 글이 많이 있었습니다. 개발 초기부터 확인하는 것이 중요하다는 것을 다시 한번 느낄 수 있었습니다.

  • 모바일 기기가 감당하지 못하는 그래픽으로 Blank 화면이 나타난다는 정보
    일부 글에서 그래픽 설정이 너무 높게 되어 있고 성능이 낮은 기기에서 그럴 수 있다는 정보가 있어서 Level에서 가장 기본적인 것만 남기고 시도했으나 결과는 동일했습니다.
  • 카메라 문제 추측
    카메라의 위치가 잘못되어 패키징 되었을 때 엉뚱한 곳을 비추고 있어서 그럴 수 있다는 생각이 들어 다른 카메라를 추가해서 확인해 보았으나 해결되지 않았습니다.
  • 빛 관련 문제
    2D 프로젝트라서 광원이 필요 없었지만 빛 관련 문제일 수도 있다는 정보를 확인하기 위해 DirectionalLight를 추가하여 확인했지만 Blank 현상은 그대로 였습니다.
  • Target SDK Version, Minimum SDK Version 변경
    SDK Version 을 변경하여 해결했다는 글을 보고 변경해 보았으나 효과가 없었습니다.
  • NavMeshBoundsVolume 문제
    NavMeshBoundsVolume 크기가 아주 크게 잡혀 있고 그 내부에 AI 관련 컴포넌트가 있어서 그 영향인지 의심이 되어 크기를 줄이고 없애도 보았지만 해결되지 않았습니다.

화면에 아무것도 나타나지 않으면 많이 당황스러운데 이 글의 정보를 바탕으로 해결이 되었으면 좋겠습니다.