Unity LZ4

💡 ARMv7 + IL2CPP 환경에서 LZ4 크래시 문제와 해결책

Unity에서 IL2CPP + ARMv7 환경에서 **LZ4 압축을 사용할 때 발생하는 정렬 문제(unaligned access)**로 인해 크래시가 발생할 가능성이 있다면, 네이티브 LZ4 라이브러리를 직접 임포트해서 사용하는 방식은 좋은 해결책이 될 수 있어.

---

🔹 문제의 원인 (Unaligned Access 문제)

• ARMv7 아키텍처는 메모리 정렬(Alignment)을 엄격하게 요구함.
• IL2CPP는 C# 코드를 변환하면서 C++ 코드에서 정렬되지 않은 메모리 접근을 그대로 수행할 수 있음.
• Mono에서는 자동으로 정렬된 접근을 보장하지만, IL2CPP에서는 개발자가 정렬을 직접 신경 써야 함.
• LZ4의 기본 구현은 빠른 처리를 위해 unaligned access를 허용하는 방식으로 설계됨, 이 때문에 크래시가 발생할 수 있음.

---

🔹 해결 방법: 네이티브 LZ4 라이브러리를 사용하기

✅ 방법 1: C++ 기반의 LZ4 네이티브 라이브러리 사용

💡 LZ4의 공식 C 구현을 빌드해서 Unity에서 P/Invoke를 통해 사용하면 문제를 해결할 수 있음.

• ARMv7 환경에서도 안전한 정렬을 보장하는 네이티브 코드로 실행됨.
• Unity의 IL2CPP와 호환 가능.
• 네이티브 최적화를 활용하여 성능이 더 좋을 수도 있음.

---

🔹 1. 네이티브 LZ4 빌드 (C++ 라이브러리)

1. LZ4 공식 리포지토리에서 최신 C++ 소스를 다운로드
   • LZ4 GitHub
2. Android용 .so 라이브러리 빌드
   • jni/Android.mk 파일을 생성 후, LZ4 C 코드 포함
   • ndk-build를 사용하여 .so 파일 생성
   • liblz4.so를 Unity의 Plugins/Android/ 폴더에 배치
3. iOS 및 Windows용 라이브러리 빌드
   • iOS: Xcode에서 liblz4.a(정적 라이브러리) 또는 liblz4.dylib(동적 라이브러리) 생성
   • Windows: Visual Studio에서 lz4.dll 빌드

---

🔹 2. Unity에서 P/Invoke로 네이티브 LZ4 호출

Unity에서 DllImport를 사용하여 네이티브 라이브러리를 호출하면 됨.

🔸 C++ 네이티브 함수 (LZ4Wrapper.cpp)

#include "lz4.h"

extern "C" {
    int LZ4_Compress(const char* src, char* dst, int srcSize, int maxDstSize) {
        return LZ4_compress_default(src, dst, srcSize, maxDstSize);
    }

    int LZ4_Decompress(const char* src, char* dst, int compressedSize, int dstCapacity) {
        return LZ4_decompress_safe(src, dst, compressedSize, dstCapacity);
    }
}

빌드 후 liblz4.so, liblz4.dylib, lz4.dll을 Unity의 Plugins 폴더에 추가.

---

🔹 3. C#에서 P/Invoke로 호출

using System;
using System.Runtime.InteropServices;

public static class LZ4Native
{
    const string LIB_NAME =
#if UNITY_IOS
        "__Internal";
#elif UNITY_ANDROID
        "liblz4";
#elif UNITY_STANDALONE_WIN
        "lz4";
#else
        "lz4";
#endif

    [DllImport(LIB_NAME, EntryPoint = "LZ4_Compress")]
    public static extern int Compress(byte[] src, byte[] dst, int srcSize, int maxDstSize);

    [DllImport(LIB_NAME, EntryPoint = "LZ4_Decompress")]
    public static extern int Decompress(byte[] src, byte[] dst, int compressedSize, int dstCapacity);
}

이제 C#에서 LZ4Native.Compress 및 LZ4Native.Decompress를 호출하면 네이티브 LZ4를 사용할 수 있음.

---

🔹 결론: 네이티브 LZ4 사용이 좋은 해결책!

✅ IL2CPP에서 발생하는 unaligned access 문제를 피할 수 있음.
✅ ARMv7 환경에서도 안정적으로 동작 가능.
✅ 성능 향상 가능 (네이티브 코드 실행 최적화).
✅ Unity의 다양한 플랫폼(Android, iOS, Windows)에서 동일한 방식으로 동작 가능.

👉 결론적으로, 네이티브 LZ4 라이브러리를 임포트해서 사용하는 것이 가장 좋은 해결 방법 중 하나야! 🚀