2025년 9월 14일 일요일

Unity Android Storage Access Framework(SAF)

 Android Storage Access Framework(SAF)

안드로이드 앱을 만들다 보면 “사용자가 파일을 직접 선택해서 열거나 저장하게 하고 싶다” 는 순간이 꼭 찾아옵니다. 예전에는 단순히 파일 경로를 받아 File API로 접근하면 됐지만, 보안이나 호환성 문제 때문에 이제는 그렇게 단순하지 않습니다. 실제 해보면 권한 없다고 오류가 발생합니다.

막상 문서 찾고 하다보면 생각보다 잘안됩니다.

이때 등장하는 게 Storage Access Framework(SAF) 입니다. 

SAF는 Android 4.4 (KitKat)부터 도입된 파일 접근 방식으로,
앱이 사용자가 직접 선택한 파일이나 폴더에만 접근할 수 있도록 도와주는 프레임워크입니다.

즉, 개발자가 마음대로 기기 저장소를 뒤지지 못하고, 사용자가 시스템이 제공하는 파일 선택 화면에서 골라준 파일에만 접근할 수 있습니다.

Unity에서 SAF를 사용하면 안드로이드 파일 선택창이 뜨게 됩니다. 여기에서 사용자가 골라주는 파일에 대해서 Read/Write가 가능해집니다.

현재 Android 전문으로 설명할것이 아니기 때문에 Unity에서 사용하는 방법만 설명을 드리겠습니다.

일단 GPT를 이용해서 SAF로 만들어 달라면 잘 만들어 줍니다. 그런데 코틀린 소스 파일도 만들어야 하고 폴더 구정에 넣어서 그래들 빌드까지 해야하는데 실제 빈 프로젝트에서는 잘 동작될지 몰라도 기존에 이미 Plugins에 Android를 사용중인 경우 뭔가 잘 되지 않습니다.


Native File Picker for Android & iOS

Asset Store 에서 유용한 Free Asset 을 찾았습니다. 

https://assetstore.unity.com/packages/tools/integration/native-file-picker-for-android-ios-173238

예제는 github 보시면 이해가 될것 입니다.

https://github.com/yasirkula/UnityNativeFilePicker#example-code

github 소스를 보면 이미 빌드가된 aar 형태로 들어있습니다. 따로 안드로이드 빌드는 안해도 되는데 NativeFilePicker.aar의 소스는 공개가 안되어 있습니다.

구조는 간단한데 예제가 거의 없어서 사용하는데 시간이 좀 걸렸습니다.

제가 사용한 예제 코드를 공유합니다. 예제에서는 샘플이므로 동작하지는 않습니다.

💾 저장하기 (Save)

아래 코드는 SaveDataStruct 데이터를 JSON으로 직렬화한 뒤, 임시 저장소(temporaryCachePath)에 기록하고, 이후 SAF 기반으로 사용자가 선택한 경로로 내보냅니다.

// 저장 코드 public void SaveGameData(SaveDataSturct data, string fileName) { // JSON 직렬화 string json = JsonConvert.SerializeObject(data, Formatting.Indented); string combinedData = $"{json}"; try { #if UNITY_ANDROID && !UNITY_EDITOR // 임시 저장 경로 string downloadPath = Application.temporaryCachePath; string fullPath = Path.Combine(downloadPath, fileName); // 파일 저장 File.WriteAllText(fullPath, combinedData); Debug.Log($"Data saved to: {fullPath}"); // SAF Export bool permission = NativeFilePicker.CheckPermission(); if (permission == true) { NativeFilePicker.ExportFile(fullPath, OnFileExported); } else { NativeFilePicker.RequestPermissionAsync((result) => { if (result == NativeFilePicker.Permission.Granted) { NativeFilePicker.ExportFile(fullPath, OnFileExported); } else { Debug.LogError("사용자가 권한을 거부했습니다."); } }); } #endif } catch (Exception ex) { Debug.LogError($"Failed to save data: {ex.Message}"); } } // ExportFile 콜백 private void OnFileExported(bool success) { if (success) { Debug.Log("File exported successfully!"); } else { Debug.Log("File export failed or cancelled."); } }

📂 불러오기 (Load)

아래 코드는 SAF 파일 선택기를 호출해 사용자가 직접 파일을 선택하고, 선택한 파일을 불러옵니다.

// 파일 로드 public void LocalLoad() { #if UNITY_ANDROID && !UNITY_EDITOR if (NativeFilePicker.IsFilePickerBusy()) return; bool permission = NativeFilePicker.CheckPermission(); if (permission == true) { OpenFilePicker(); } else { NativeFilePicker.RequestPermissionAsync((result) => { if (result == NativeFilePicker.Permission.Granted) { OpenFilePicker(); } else { Debug.LogError("사용자가 권한을 거부했습니다."); } }); } #endif } private void OpenFilePicker() { NativeFilePicker.PickFile((path) => { if (path == null) { Debug.Log("Operation cancelled"); } else { Debug.Log("Picked file: " + path); LocalLoadReal(path); } }, new string[] { "text/plain" }); // 허용할 파일 MIME 타입 지정 } private void LocalLoadReal(string fullPath) { if (!File.Exists(fullPath)) { Debug.LogWarning("Save file not found!"); return; } try { // 파일 읽기 샘플 string[] lines = File.ReadAllLines(fullPath); Debug.Log($"Data loaded from: {fullPath}"); // TODO: lines를 역직렬화해서 SaveDataStruct로 변환 } catch (Exception ex) { Debug.LogError($"Failed to load data: {ex.Message}"); return; } }


2025년 9월 13일 토요일

Playstore console 앱이 16KB 메모리 페이지 크기를 지원해야 합니다.

 얘네(구글)들은 뭔가 변경 사항을 미리미리 예측못하는가? 갑자기 저런 공지를 날려서 3개월만에 해결하라고 ... 

앱단이 아니라 OS 단에서 패딩을 넣어주면 되는것 아닌가 싶기도 한데... 출시한지 오래된 앱의 경우, 갑작스런 대응이 쉽지는 않습니다.


 unity 관련 공지는 아래에서 찾을 수 있었습니다.

https://discussions.unity.com/t/info-unity-engine-support-for-16-kb-memory-page-sizes-android-15/1589588

아래 이상의 버전을 사용해서 빌드만 하면 되는데 문제는 버전업하면 어떤 일이 일어 날지 모르니... API가 조금 바뀌는 경우도 있고.... 적절한 버전을 업데이트 해서 해결하면됩니다.

  • Unity 6000.1+ released February 9, 2025
  • Unity 6000.0.38f1+ released February 14, 2025
  • Unity 2022.3.56f1+ released January 15, 2025
  • Unity 2021.3.48f1+ released January 22, 2025 accessible under extended LTS support for Enterprise/Industry customers

저의 경우 2022.3.10f1 사용중이라서 에디터 버전 2022.3.62f1 으로 업데이트 하였습니다.

다행이 오류는 없었고, target API Level을 최신으로 올려서 빌드하였습니다.

target API level은 Player setting Other 쪽에 있습니다.




-업데이트-

2개의 앱을 작업했는데 하나의 앱에서 여전히 에러가 사라지지 않는 경우가 있어서 추가로 확인을 하였습니다.


아래 라이브러리들이 여전히 안되는 경우가 있음

메모리 페이지 크기
16KB를 지원하지 않음
16KB를 지원하지 않는 라이브러리: base/lib/arm64-v8a/libAdaptivePerformanceAndroid.so base/lib/arm64-v8a/libAdaptivePerformanceHint.so base/lib/arm64-v8a/libAdaptivePerformanceThermalHeadroom.so

찾아보니 해당 라이브러리는 "Unity Adaptive Performance" 사용함으로서 발생하는 포함되는 lib 인데

https://developer.android.com/games/engines/unity/unity-adpf?hl=ko

Unity Adaptive Performance는 제공자가 기기에서 필요한 모든 정보를 가져와야 합니다. Android 제공업체는 Adaptive Performance 5.0 이상에서 지원되며 Unity 2021.3 이상을 지원합니다. Unity 2021 및 2022 버전 패키지 관리자는 Adaptive Performance 4.0을 다운로드하므로 버전 5.0으로 수동 업데이트해야 합니다.


5.0으로 업데이트 하라는 문구는 보이는데 해결 될지 몰라서 성능 관련 내용이라 삭제하기로 마음 먹고 삭제 했습니다.




2025년 3월 30일 일요일

Python의 requests 큰파일 다운로드시 처리 방법

 requests 사용시 아무 생각 없이 사용하곤 했었습니다. 그런데 어느 순간 thread가 강제 종료 되는 현상이 발생하였습니다. 구체적인 사유는 없는데 큰파일 다운로드시 발생하는 증상이 었습니다. 제가 사용할때는 ubuntu에서 3G 크기의 파일이었습니다.

메모리 부족 같아서 검색해보니 stream을 사용해야 한다고 합니다.

GPT를 이용해서 가이드를 받아서 코드를 수정했지만 사유없이 종료되는 경우 메모리 부족을 의심하시기 바랍니다.


import requests


url = 'https://example.com/largefile.zip'  # 다운로드할 파일의 URL

file_name = 'largefile.zip'  # 저장할 파일 이름


# 청크 단위로 다운로드

with requests.get(url, stream=True) as response:

    response.raise_for_status()  # 요청이 성공했는지 확인

    with open(file_name, 'wb') as file:

        for chunk in response.iter_content(chunk_size=8192):  # 8KB 단위로 읽기

            file.write(chunk)


print(f"{file_name} 다운로드 완료.")



2025년 3월 3일 월요일

stable diffusion webui with amd gpu

 RX 7700 XT GPU를 가지고 windows에서 stable diffusion을 동작시키기 위한 시행 착오에 대해서 정리해보았습니다.

누군가는 동일한 시행 착오를 격지 않길 바라는 마음에 정리를 해보았습니다.

따라하지 마시고 끝까지 다읽어 보시는걸 추천 드립니다. 


NVIDIA의 막강한 무기가 CUDA인걸 모르는지 시간이 많이 지났음에도 AMD의 개발 환경은 여전히 쉽지 않았습니다.

요즘 딥러닝하면 pytorch를 많이 사용합니다. 그래서 pytorch site에서 설치하는 방법을 살펴 보았습니다.

여기에서부터 고행은 시작되었습니다.

 


ROCm(Radeon Open Compute)은 AMD에서 개발한 오픈 소스 기반의 GPU 컴퓨팅 플랫폼입니다. 이는 NVIDIA의 CUDA와 유사한 개념으로, AMD GPU에서 고성능 병렬 컴퓨팅을 수행할 수 있도록 설계되었습니다.
ROCm 이 Windows 에서 설치가 불가능 하였습니다.

Linux 에서는 설치가 가능했기 때문에 WSL을 이용해서 설치를 시도하였습니다.

**WSL(Windows Subsystem for Linux)**은 Windows에서 직접 Linux 환경을 실행할 수 있도록 하는 기능입니다.
즉, 가상 머신(VM) 없이 Windows에서 Linux 명령어, 도구, 애플리케이션을 사용할 수 있도록 지원하는 Microsoft의 서브시스템입니다.


아래를 참고해서 6.1.3 버전을 설치하였습니다.

https://www.reddit.com/r/ROCm/comments/1ep4cru/rocm_613_complete_install_instructions_from_wsl/

문제는 여전히 CUDA를 인식하지 못하는 이슈가 있었습니다.

다시 아래 AMD의 WSL 가이드를 이용하여 ROCm 6.2.3 버전 설치를 시도 하였습니다.

https://rocm.docs.amd.com/projects/radeon/en/latest/docs/install/wsl/install-radeon.html

여전히 unsupported GPU라고 뜹니다.

여기저기 찾아보니 내장 그래픽 카드를 off 하라고 해서 BIOS에서 Off 설정을 해보았지만 여전히 동일하였습니다.


여기에서 자세한 설명은 안하였지만 wsl 내에서 docker 이미지를 이용해서도 설치해보았습니다. 여전히 인식하지 못하였습니다.

중요한 문서가 있는데... 지원되는 그래픽 카드가 정해져 있다는 것입니다.

https://rocm.docs.amd.com/projects/radeon/en/latest/docs/compatibility/wsl/wsl_compatibility.html

이쯤와서는 거의 다 포기하였습니다.

stable diffusion 은 directml(윈도우의 DirectX12 API) 이란것을 이용해서 동작시키는 방법이 있었습니다. 또 다른 방법은 ZLUDA를 이용하는 방법인데 AMD GPU를 이용해서 CUDA 흉내를 내는 방식입니다.

그래서 아래 코드를 참고해서 git 을 받고 

https://github.com/lshqqytiger/stable-diffusion-webui-amdgpu

아래와 같이 실행하였습니다. 물론 그전에 python 3.10.6 버전을 꼭 설치해야합니다.

webui-user.bat --use-zluda


Using ZLUDA

Most of AMDGPUs are compatible.

Start WebUI with --use-zluda.


정리해 보면 아래와 같습니다.

Automatic Installation on Windows

  1. Install Python 3.10.6 (Newer version of Python does not support torch), checking "Add Python to PATH".
  2. Install git.
  3. Download the stable-diffusion-webui-amdgpu repository, for example by running git clone https://github.com/lshqqytiger/stable-diffusion-webui-amdgpu.git.
  4. Run webui-user.bat from Windows Explorer as normal, non-administrator, user.

4번 실행시 webui-user.bat --use-zluda 라고 실행 시키면 됩니다.


동작하다가 numpy 관련 오류가 발생하는데 아래 가이드 보고 pip install numpy==1.23.5 로 새로 설치하였습니다.

https://myview7144.tistory.com/96


최초 동작시 NVIDIA 사용할때보다 굉장히 느립니다.

동작은 되는데 이미지 크기를 키우면 굉장히 느려집니다.

 

2025년 1월 27일 월요일

Unity New Input System pinch zoom, 핀치 줌

Unity6가 되면서 기본적으로 new input system을 기본으로 포함해서 따로 추가 설치가 필요 없게 되었습니다.

android로 개발하다 보니 pinch zoom이 필요하게 되어서 여기저기 검색도 해봤는데 멀티 터치가 생각보다 디버깅이 힘들었습니다.

제가 작업한 코드를 공개합니다. 디버깅 코드를 풀어서 디버깅 해가면서 적절하게 값을 조절 해서 사용해야 합니다.

카메라의 아래값을 변경하는 코드인데 이 환경은 프로젝트 마다 다를 수 있으므로 해당 부분을 참고하는것보다 저기에 넘기는 값을 보시기 바랍니다.

_camera.orthographicSize

아래는 전체 코드입니다. 다음 feature 부분을 참고 하세요. USE_NEW_INPUT

using UnityEngine;
#if USE_NEW_INPUT
using UnityEngine.InputSystem;
using UnityEngine.InputSystem.EnhancedTouch;
#endif

public class CameraFollow : MonoBehaviour
{
    public Transform player; // 플레이어의 Transform
    public float smoothSpeed = 0.125f; // 부드러운 이동 속도
    public Vector3 offset;         // 카메라와 플레이어 간의 거리

    public bool lockX = false;     // X축 고정 여부
    public bool lockY = false;     // Y축 고정 여부

    public bool useBounds = false; // 경계 제한 사용 여부
    public Vector2 minBounds;      // 카메라 이동 최소값 (X, Y)
    public Vector2 maxBounds;      // 카메라 이동 최대값 (X, Y)

    public Camera _camera;
    public int skipFrame = 1;
    private int curFrame;

    public bool useZoom = false;
    public float zoomSpeed = 1f;
    public float minSize = 2f;
    public float maxSize = 10f;
    void Start()
    {
        if( _camera ==null ){
            _camera = Camera.main;
        }
       
    }
    private void OnEnable() {
        #if USE_NEW_INPUT
        UnityEngine.InputSystem.EnhancedTouch.EnhancedTouchSupport.Enable();
        #endif
    }
    private void OnDisable() {
        #if USE_NEW_INPUT
        UnityEngine.InputSystem.EnhancedTouch.EnhancedTouchSupport.Disable();
        #endif
    }
    void LateUpdate()
    {
        if (player == null) return;
        //if (curFrame < skipFrame)
        //{
        //    curFrame++;
        //    return;
        //}
        //curFrame = 0;

        // 목표 위치 계산
        Vector3 targetPosition = new Vector3(
            lockX ? transform.position.x : player.position.x + offset.x, // X축 고정 여부 확인
            lockY ? transform.position.y : player.position.y + offset.y, // Y축 고정 여부 확인
            transform.position.z // Z축은 고정
        );

        // 부드럽게 이동
        Vector3 smoothedPosition = Vector3.Lerp(transform.position, targetPosition, smoothSpeed);

        // 경계 제한 적용
        if (useBounds)
        {
            smoothedPosition.x = Mathf.Clamp(smoothedPosition.x, minBounds.x, maxBounds.x);
            smoothedPosition.y = Mathf.Clamp(smoothedPosition.y, minBounds.y, maxBounds.y);
        }

        // 새로운 위치 적용
        transform.position = smoothedPosition;

        if(useZoom){
            float scrollInput = 0;
            #if USE_NEW_INPUT
                Vector2 scrollInputV2 = Mouse.current.scroll.ReadValue();
                scrollInput = scrollInputV2.y;
            #else
                scrollInput = Input.GetAxis("Mouse ScrollWheel");
            #endif


            if (scrollInput != 0)
            {
                _camera.orthographicSize -= scrollInput * zoomSpeed;
                Debug.Log("scrollInput: " + scrollInput);
                _camera.orthographicSize = Mathf.Clamp(_camera.orthographicSize, minSize, maxSize);
            }
            #if USE_NEW_INPUT
                if( UnityEngine.InputSystem.EnhancedTouch.Touch.activeTouches.Count == 2 ){
                    UnityEngine.InputSystem.EnhancedTouch.Touch touch1 = UnityEngine.InputSystem.EnhancedTouch.Touch.activeTouches[0];
                    UnityEngine.InputSystem.EnhancedTouch.Touch touch2 = UnityEngine.InputSystem.EnhancedTouch.Touch.activeTouches[1];
                    Vector2 touch1PrevPos = touch1.screenPosition - touch1.delta;
                    Vector2 touch2PrevPos = touch2.screenPosition - touch2.delta;

                    float prevTouchDelta = (touch1PrevPos - touch2PrevPos).magnitude; // 이전 프레임에서의 거리
                    float currentTouchDelta = (touch1.screenPosition - touch2.screenPosition).magnitude; // 현재 프레임에서의 거리

                    float deltaMagnitudeDiff = prevTouchDelta - currentTouchDelta;
                    //Debug.Log("scrollInput1: " + deltaMagnitudeDiff);
                    deltaMagnitudeDiff = Mathf.Clamp(deltaMagnitudeDiff, -0.5f, 0.5f);
                    //Debug.Log("scrollInput2: " + deltaMagnitudeDiff);
                    _camera.orthographicSize += deltaMagnitudeDiff * zoomSpeed;
                    _camera.orthographicSize = Mathf.Clamp(_camera.orthographicSize, minSize, maxSize);
                }
                if( UnityEngine.InputSystem.EnhancedTouch.Touch.activeTouches.Count >= 2 ){
                    GameManager.instance.isMultiTouch = true;
                }else{
                    GameManager.instance.isMultiTouch = false;
                }
            #else
                // 두 개의 터치 입력을 받았는지 확인
                if (Input.touchCount == 2)
                {
                    Touch touch1 = Input.GetTouch(0);
                    Touch touch2 = Input.GetTouch(1);

                    // 각 터치의 현재 및 이전 위치 간 거리 계산
                    Vector2 touch1PrevPos = touch1.position - touch1.deltaPosition;
                    Vector2 touch2PrevPos = touch2.position - touch2.deltaPosition;

                    float prevTouchDelta = (touch1PrevPos - touch2PrevPos).magnitude; // 이전 프레임에서의 거리
                    float currentTouchDelta = (touch1.position - touch2.position).magnitude; // 현재 프레임에서의 거리

                    float deltaMagnitudeDiff = prevTouchDelta - currentTouchDelta;
                    Debug.Log("scrollInput1: " + deltaMagnitudeDiff);
                    deltaMagnitudeDiff = Mathf.Clamp(deltaMagnitudeDiff, -0.5f, 0.5f);
                    Debug.Log("scrollInput2: " + deltaMagnitudeDiff);
                    _camera.orthographicSize += deltaMagnitudeDiff * zoomSpeed;
                    _camera.orthographicSize = Mathf.Clamp(_camera.orthographicSize, minSize, maxSize);
                }
            #endif
        }
    }
   
}

2025년 1월 6일 월요일

dialogue system for unity 사용중 android 장치에서 터치 동작이 안되는 경우

프로젝트에서 Dialogue Manager를 사용하면 Android 휴대전화에서 터치가 전혀 작동하지 않습니다. 에디터 모드에서는 정상 동작하였습니다.

Dialogue Manager 에 Input Device Manager 를 제거 해서 테스트 해보시기 바랍니다. (개발자로부터 답변 받음) 저는 이렇게 해결했습니다.


Input Device Manager - 조이스틱이나 마우스 장치 전환을 위한 것이라고 합니다. 따라서 터치를 사용하는 휴대폰의 경우 필요 없다고 합니다.

이것 때문에 하루를 소비했네요. 진작 개발자에게 문의해볼 걸 그랬습니다. 참고로 개발자 답변이 굉장히 빠릅니다....


2025년 1월 5일 일요일

unity android debugging시 무한 경고

 

Unity 에서 안드로이드 디버깅시 이런식으로 무한 로그가 발생하는 경우 

2025-01-05 21:53:07.298 23202 23385 Warn Unity VULKAN: GENERAL WARNING: The following warning was triggered: VKDBGUTILWARN003. Please refer to the Adreno Game Developer Guide for more information: https://developer.qualcomm.com/sites/default/files/docs/adreno-gpu/snapdragon-game-toolkit/learn_guides.html


https://developer.qualcomm.com/sites/default/files/docs/adreno-gpu/snapdragon-game-toolkit/learn_guides.html 여기 홈페이지 가봐도 링크 깨져 있습니다.

로그가 무한이 나와서 다른 로그를 볼 수 없는 상태가 됩니다.

불칸을 디버깅 했을때 발생하는 현상인데 자세한 내용을 찾을 수 없어서 그래픽쪽 문제가 아니라면 불칸을 끄면 해결이 됩니다.

끄는 방법은 unity6에서 player > other settings > auto graphics API (선택해제) > OpenGLES3 를 위쪽으로 끌어 올리면 됩니다. 

디버깅 후 auto graphics API 값이 기본 enable 이므로 check 하시면 됩니다..