> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ko/self-hosted/sdks/ios-sdk.md).

# iOS SDK

학습된 Roboflow 모델을 iOS 앱에 배포합니다

Roboflow Mobile iOS SDK는 추론 속도를 높이거나 증강 현실과 같은 새로운 기능, 역량, 사용 사례를 활용하기 위해 엣지(iPad 또는 iPhone)에서 모델을 실행해야 하는 iOS 애플리케이션을 개발하는 경우 훌륭한 선택입니다.

커스텀 컴퓨터 비전 모델을 내장한 네이티브 모바일 애플리케이션을 사용하면 개발자는 앱에 시각 능력을 부여할 수 있습니다.

## 작업 지원

iOS SDK 배포에서 지원하는 작업 유형은 다음과 같습니다.

| 작업 유형      | iOS SDK 배포 지원 |
| ---------- | ------------- |
| 객체 감지      | ✅             |
| 분류         |               |
| 인스턴스 분할    | ✅ (iOS 18 이상) |
| 시맨틱 세그멘테이션 |               |

### CoreML 내보내기 호환성

다음 모델 아키텍처는 온디바이스 배포를 위한 CoreML (`.mlpackage`) 내보내기를 지원합니다.

| 모델       | CoreML 내보내기 |
| -------- | ----------- |
| RF-DETR  | ✅           |
| YoloLite | ✅           |
| 분류 모델    | ✅           |

## iOS 기기에 모델 배포하기

### 지원 하드웨어 및 소프트웨어

모든 iOS 기기는 온디바이스 추론을 지원하지만, iPhone 8(A11 Bionic 프로세서)보다 오래된 기기에서는 에너지 효율이 낮은 GPU 엔진으로 전환됩니다.

Roboflow를 사용하려면 iOS 15.4 이상이 필요합니다(인스턴스 분할 모델은 iOS 18.0 이상).

## 프로토타이핑

다음을 사용해 개발할 수 있습니다. [Roboflow Serverless Cloud API](https://docs.roboflow.com/deployment/ko/legacy/legacy-serverless.md). 이 API는 온디바이스 추론과 동일한 학습 모델을 사용합니다.

## 설치

* 설치 [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) | [문제 해결 가이드](https://guides.cocoapods.org/using/troubleshooting#installing-cocoapods)

"CocoaPods는 Ruby로 개발되며 macOS에서 기본으로 제공되는 Ruby를 사용해 설치할 수 있습니다. Ruby 버전 관리자를 사용할 수도 있지만, 잘 알고 있는 경우가 아니라면 macOS에서 기본으로 제공되는 Ruby를 사용하는 것이 좋습니다. 기본 Ruby를 설치해 사용하면 gem을 설치할 때 `sudo` 를 사용해야 합니다. (다만 이는 gem을 설치하는 동안에만 문제가 됩니다.)" - [CocoaPods](https://guides.cocoapods.org/using/getting-started.html)

이 과정에서 RubyGems에 관리자 권한을 부여하고 싶지 않다면 "Sudo 없이" 설치하는 방법도 있습니다. 다만 `sudo` 를 사용한 설치가 더 일반적이라는 점에 유의하세요.

터미널에서 다음을 입력해 CocoaPods가 성공적으로 설치되었는지 확인합니다. `pod --version` 프로젝트 디렉터리에서

### Roboflow CocoaPod 설치하기

먼저 다음 명령을 실행합니다. `pod init` 프로젝트 디렉터리에서 실행합니다.

다음 항목이 `Podfile` 에 지정되어 있는지 확인합니다. `platform :ios, '15.4'`

그런 다음 다음 항목을 추가합니다. `pod 'Roboflow'` 다음 파일에 추가합니다. `Podfile`.

XCode Command Line Tools가 설치되어 있지 않다면 다음을 실행합니다. `xcode-select --install` 터미널에서 실행합니다.

다음과 같은 결과가 반환됩니다. `xcode-select: error: command line tools are alreadyinstalled, use "Software Update" to install updates` 시스템에 Command Line Tools가 이미 설치되어 있는 경우입니다.

마지막으로 다음을 실행하고 `pod install` 생성된 `.xcworkspace` 파일을 [XCode](https://developer.apple.com/xcode/).

![Podfile 설치가 성공적으로 완료된 후의 터미널](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-742fddf172d5eea914ea63a42170583cbe748443%2Fimage%20\(173\).png?alt=media)

![Podfile 설치가 성공적으로 완료된 후의 프로젝트 디렉터리](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-85737dbd1b9fcb80ea6674633012e85c908f5c30%2Fimage%20\(202\).png?alt=media)

* 다음 오류가 반환되면: "Ruby 인터프리터 또는 확장 라이브러리에서 버그가 발생했을 수 있습니다." 먼저 다음을 실행한 후 `brew install cocoapods`다음을 실행하고 `pod install` 생성된 `.xcworkspace` 파일을 XCode에서 엽니다.
  * 터미널에서 다음을 입력해 CocoaPods가 성공적으로 설치되었는지 확인합니다. `pod --version` 프로젝트 디렉터리에서

### Swift에서 Roboflow 사용하기

다음으로 이동하여 `.xcworkspace` 파일을 XCode에서 엽니다.

![](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-845222e3655098babfff65dff3575a9886c12c24%2Fimage%20\(278\).png?alt=media)

그런 다음 다음을 추가해 Roboflow를 가져옵니다. `import Roboflow`를 `.xcworkspace` 파일에 추가합니다.

그런 다음 다음을 사용해 Roboflow API 인스턴스를 생성합니다. `let rf = Roboflow(apiKey: "API_KEY")`. `modelVersion`의 경우 `YOUR-MODEL-VERSION-#` 를 모델 버전 번호의 정수 값으로 바꿉니다.

#### 프로젝트 정보 찾기

**완료 핸들러 사용법:**

```swift
import Roboflow
...
//API 키로 초기화
let rf = RoboflowMobile(apiKey: "API_KEY")
var model: RFModel?
...

//model은 모델의 프로젝트 이름입니다
rf.load(model: "YOUR-MODEL-ID", modelVersion: YOUR-MODEL-VERSION-#) { [self] model, error, modelName, modelType in
    if error != nil {
        print(error?.localizedDescription as Any)
    } else {
        model?.configure(threshold: threshold, overlap: overlap, maxObjects: maxObjects
                            processingMode: .performance or .balanced or .quality, // 인스턴스 세그멘테이션
                            maxNumberPoints: 마스크 처리 포인트의 최대 개수) // 인스턴스 세그멘테이션
        self.model = model
    }
    
}
...

//model?.detect는 UIImage를 받아 추론을 실행합니다
let img = UIImage(named: "example.jpeg") // 또는 CVPixelBuffer
model?.detect(image: img!) { predictions, error in
    if error != nil {
        print(error)
    } else {
        print(predictions)
    }
}
```

**비동기 사용:**

비동기 방식으로 사용하려면 비동기 블록 내에서 Roboflow 모델을 호출해야 합니다.

```swift
import Roboflow
...
//API 키로 초기화
let rf = RoboflowMobile(apiKey: "API_KEY")
...

//model은 모델의 프로젝트 이름입니다
let (model, loadingError, modelName, modelType) = await rf.load(model: "YOUR-MODEL-ID", modelVersion: YOUR-MODEL-VERSION-#)
model!.configure(threshold: threshold, overlap: overlap, maxObjects: maxObjects)
...

//model?.detect는 UIImage를 받아 추론을 실행합니다
let img = UIImage(named: "example.jpeg")
let (predictions, predictionError) = await model!.detect(image: img!)
print(predictions)
```

**예측 형식:**

```
x:Float //객체의 중심 x 좌표
y:Float //객체의 중심 y 좌표
width:Float
height:Float
className:String
confidence:Float
color:UIColor
box:CGRect
points:[CGPoint] // 인스턴스 분할 모델에만 해당
```

[CGRect](https://developer.apple.com/documentation/corefoundation/cgrect)

### 네이티브 Swift 예제

다음 [roboflow-ios-starter](https://github.com/roboflow/roboflow-ios-starter) 앱은 Roboflow 모델을 사용하는 실시간 iOS 앱을 만들기 위한 훌륭한 시작점입니다. 객체 감지 및 인스턴스 분할 모델 모두에 대한 카메라 설정, 모델 로드 및 처리, 출력 그리기 코드가 포함되어 있습니다.

### React Native Expo 앱 예제

이 SDK를 React Native 기반 Expo 앱에 통합하는 예제도 여기에서 제공합니다. 자체 다운스트림 애플리케이션을 구축할 때 참고하면 유용합니다.

다음 두 항목이 모두 설치되어 있는지 확인하세요: [Expo](https://docs.expo.dev/) 및 [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) 를 설치해야 합니다.

* `expo-cli` 는 다음 Node.js 버전을 지원합니다: `>=12.13.0 <15.0.0` (유지보수 LTS) 및 `>=16.0.0 <17.0.0` (활성 LTS)
* Node.js용 yarn 패키지를 설치해야 합니다 (`npm install -g yarn`)

{% embed url="<https://github.com/roboflow-ai/RoboflowExpoExample>" %}

### iOS 애플리케이션 예제 - CashCounter

다운로드 [CashCounter](https://apps.apple.com/app/roboflow-cash-counter/id1633812788)는 미국 동전과 지폐를 세는 예제 iOS 앱으로, 컴퓨터 비전 모델을 iPhone에 배포하는 방법을 보여 줍니다. 경계 상자 시각화, FPS, 객체 개수 세기, 이미지 업로드 등의 예제를 확인할 수 있습니다.
