연결 (Linking)

React Native 0.68+

React Native v0.68 이상부터는 Autolinking을 통해 연결이 자동으로 이루어집니다. 수동 연결은 필요하지 않습니다.

iOS

설치 후 ios 디렉토리로 이동하여 CocoaPods 종속성을 설치합니다:

cd ios && pod install

Android

추가 단계가 필요하지 않습니다. 빌드 프로세스 중에 라이브러리가 자동으로 연결됩니다.

---

더 이상 사용되지 않음 (Deprecated)

더 이상 지원되지 않음

다음 섹션은 레거시 버전 전용입니다. React Native 0.68+ 및 **react-native-screenguard v1.0.8+**를 사용하는 경우 이 섹션 전체를 건너뛸 수 있습니다.

React Native 0.59 이하 (수동 연결)

v2.0.0+에서 지원되지 않음

React Native 0.59 이하는 v2.0.0에서 더 이상 지원되지 않습니다. 최신 버전을 사용하려면 React Native 0.68+로 업그레이드하세요.

iOS 수동 연결

1. Xcode의 프로젝트 내비게이터에서 Libraries를 마우스 오른쪽 버튼으로 클릭합니다.
2. **Add Files to [프로젝트 이름]**을 선택합니다.
3. node_modules/react-native-screenguard로 이동하여 ScreenGuard.xcodeproj를 추가합니다.
4. 내비게이터에서 프로젝트를 선택하고 Build Phases → Link Binary With Libraries로 이동합니다.
5. libScreenguard.a를 추가합니다.

Android 수동 연결

1. android/app/src/main/java/[...]/MainActivity.java를 엽니다:

import com.screenguard.ScreenGuardPackage; // 이 import 추가

// getPackages() 메서드에 추가:
new ScreenGuardPackage()

2. android/settings.gradle에 추가:

include ':react-native-screenguard'
project(':react-native-screenguard').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-screenguard/android')

3. android/app/build.gradle 종속성에 추가:

implementation project(':react-native-screenguard')

Android 사후 설치 (v1.0.6 이하)

v1.0.8+에서는 필요하지 않음

v1.0.8부터는 액티비티가 라이브러리의 AndroidManifest.xml에 자동으로 선언되며 빌드 중에 병합됩니다. 이 단계는 v1.0.6 이하 버전에서만 필요합니다.

v1.0.6 이하 버전의 경우 배경색 및 블러 효과를 활성화하려면 AndroidManifest.xml에 ScreenGuardColorActivity를 수동으로 선언해야 합니다.

1단계: AndroidManifest.xml 업데이트

android/app/src/main/AndroidManifest.xml을 열고 액티비티를 추가합니다:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application ...>
        <activity android:name=".MainActivity" ...>
            ...
        </activity>

        <!-- 이 액티비티 추가 -->
        <activity
            android:name="com.screenguard.ScreenGuardColorActivity"
            android:theme="@style/Theme.AppCompat.Translucent"
            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
            android:windowSoftInputMode="stateAlwaysVisible|adjustResize"
            android:exported="false"
        />
    </application>
</manifest>

2단계: 반투명 테마 추가

android/app/src/main/res/values/styles.xml을 열고 테마를 추가합니다:

<resources>
    <style name="AppTheme">
        <!-- 기존 테마 -->
    </style>

    <!-- 이 테마 추가 -->
    <style name="Theme.AppCompat.Translucent">
        <item name="android:windowNoTitle">true</item>
        <item name="android:windowBackground">@android:color/transparent</item>
        <item name="android:colorBackgroundCacheHint">@null</item>
        <item name="android:windowIsTranslucent">true</item>
        <item name="android:windowAnimationStyle">@null</item>
        <item name="android:windowSoftInputMode">adjustResize</item>
    </style>
</resources>