
Integrated in-app photo, video, motion-image and audio editors with picker, background removal, watermark locking, multi-item PDF/GIF export, persistent edit sessions, customizable UI theme and localization.
FrameKit은 Android와 iOS 앱에 사진, 영상, 움직이는 이미지, 음성 편집 화면을 붙이는 SDK입니다. 편집기를 열면 고르기부터 편집, 저장까지 화면이 모두 들어 있고, 앱은 결과 파일만 받으면 됩니다. 원본 파일은 바꾸지 않습니다. 두 플랫폼의 기능과 화면, 결과 형식은 같고, 한쪽에서 쓸 수 없는 기능만 빠져 있습니다.
| Android | iOS | |
|---|---|---|
| 최소 버전 | Android 8.0 (API 26) | iOS 15 |
| 개발 환경 | Kotlin 2.2 이상, Compose 없이도 사용 | Xcode 16 이상, Swift 5·6 |
| 배포 | Maven Central com.naurylab:framekit
|
Swift Package Manager (컴파일된 FrameKit.xcframework) |
| 진입점 |
FrameKitContract (Activity Result) |
.frameKitEditor (SwiftUI), FrameKitViewController (UIKit) |
recorderPresentation).윗줄은 다크 테마, 아랫줄은 라이트 테마입니다.
![]() 사진 편집 |
![]() 문서 스캔 |
![]() 갤러리 |
![]() 영상 편집 |
![]() 움직이는 이미지 |
![]() 녹음 |
![]() 음성 편집 |
![]() 워터마크 |
폴드에서는 이렇게 보입니다.
![]() 사진 편집 도구를 옆 패널에 |
![]() 영상 편집 반쯤 접으면 위는 영상, 아래는 도구 |
![]() 갤러리 폭에 맞춰 늘어나는 격자 |
고르기·사진 편집은 다크 테마, 영상·움직이는 이미지·음성은 라이트 테마입니다.
![]() 고르기 |
![]() 사진 편집 |
![]() 영상 편집 |
![]() 움직이는 이미지 |
![]() 음성 편집 |
상태 바가 옆에 있는 듀오의 덮개 화면에서는 이렇게 보입니다(사진 편집은 다크, 나머지는 라이트).
![]() 사진 편집 오른쪽 상태 바를 피해 배치 |
![]() 영상 편집 타임라인과 도구가 화면 폭에 맞춤 |
![]() 혼합 편집 아래 줄에서 사진과 영상을 오감 |
ios/FrameKit.xcodeproj에서 FrameKitSample을 실행합니다. 편집기별 예제, 결과 보기, 테마·언어·저장 형식을 바꾸는 설정 탭이 들어 있습니다.// settings.gradle.kts
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
}
}
// app/build.gradle.kts
dependencies {
implementation("com.naurylab:framekit:1.0.0-alpha15")
}필요한 편집기만 쓰려면 그 모듈만 넣습니다.
| 모듈 | 내용 |
|---|---|
framekit |
전체 편집기와 통합 진입점 FrameKitContract
|
framekit-ui-image |
사진 편집기 ImageEditorContract
|
framekit-ui-video |
영상 편집기 VideoEditorContract
|
framekit-ui-motion |
움직이는 이미지 편집기 MotionEditorContract
|
framekit-ui-audio |
음성 편집기 AudioEditorContract
|
framekit-picker |
앱 안 갤러리 MediaPickerContract
|
framekit-scanner |
카메라 문서 스캐너 DocumentScanContract
|
framekit-segmentation |
배경 제거 (선택) |
framekit-ocr |
PDF 글자 검색 (선택) |
R8 규칙을 따로 넣을 필요는 없습니다.
Xcode에서 **File › Add Package Dependencies…**를 고르고 아래 주소를 넣습니다. FrameKit 하나에 모든 편집기가 들어 있습니다.
https://github.com/Naury74/Naury-Frame-Kit-SDK
// Package.swift
.package(url: "https://github.com/Naury74/Naury-Frame-Kit-SDK", exact: "1.0.0-alpha15")카메라나 마이크를 쓰는 기능이 있으면 앱 Info.plist에 아래 권한 사용 설명을 추가하세요. 사진·영상 고르기는 시스템 선택기를 써서 사진 접근 권한이 필요 없습니다.
| 키 | 필요한 때 |
|---|---|
NSCameraUsageDescription |
사진 찍기·영상 녹화 |
NSMicrophoneUsageDescription |
영상 녹화, 음성 녹음 |
class MainActivity : ComponentActivity() {
private val editor = registerForActivityResult(FrameKitContract()) { result ->
when (result) {
is FrameKitResult.Success -> show(result.output.uri, result.output.mediaType)
FrameKitResult.Cancelled -> Unit
is FrameKitResult.Failure -> showError(result.error.code)
}
}
// 사용자가 고른 파일 종류에 맞는 편집기가 열린다.
fun edit() = editor.launch(FrameKitRequest(EditorInput.Pick(MediaKind.ANY)))
}입력은 이렇게 고릅니다.
EditorInput.UriSource(uri) // 파일 하나
EditorInput.Multiple(uris.map(EditorInput::UriSource)) // 파일 여러 개
EditorInput.Pick(MediaKind.IMAGE, maxItems = 10) // 갤러리에서 사진 최대 10장
EditorInput.Capture(MediaKind.IMAGE) // 찍은 뒤 편집. AUDIO면 녹음 뒤 편집도구, 저장 형식, 테마는 요청에 함께 넘깁니다.
FrameKitRequest(
EditorInput.UriSource(uri),
image = ImageEditorConfig(enabledTools = setOf(ImageTool.CROP, ImageTool.ROTATE)),
imageExport = ImageExportConfig(format = ImageFormat.PNG, maxWidth = 2048),
ui = EditorUiConfig(themeMode = ThemeMode.LIGHT, primaryArgb = 0xFF1E6BFF.toInt()),
)결과 파일은 앱 내부 저장소에 저장되고 content:// Uri로 옵니다. 다른 앱과 공유할 때는 Intent에 FLAG_GRANT_READ_URI_PERMISSION을 붙이고, 필요 없어지면 FrameKitOutputs.deleteOutput(context, uri)로 지웁니다. 할 일 고르기 시트, 사진·영상 혼합 편집, 문서 스캔, 화면 없이 처리, 앱 전용 필터와 스티커는 Android 연동 가이드에 있습니다.
SwiftUI는 .frameKitEditor 수정자로 띄웁니다.
import FrameKit
struct ContentView: View {
@State private var showEditor = false
var body: some View {
// 사용자가 고른 파일 종류에 맞는 편집기가 열린다.
Button("편집") { showEditor = true }
.frameKitEditor(isPresented: $showEditor, request: FrameKitRequest(input: .pickMultiple(maxItems: 10))) { result in
switch result {
case .success(_, let outputs): show(outputs)
case .cancelled: break
case .failure(let error): showError(error.code)
}
}
}
}UIKit은 FrameKitViewController를 present합니다. 편집기가 스스로 닫힌 뒤 completion을 한 번 부릅니다.
let editor = FrameKitViewController(request: FrameKitRequest(input: .pickMultiple(maxItems: 10))) { result in
if case .success(_, let outputs) = result { show(outputs) }
}
present(editor, animated: true)입력은 이렇게 고릅니다. 고를 종류는 mediaKind(.image, .video, .any, .audio)로 정합니다.
FrameKitRequest(input: .file(url)) // 파일 하나
FrameKitRequest(input: .files(urls)) // 파일 여러 개
FrameKitRequest(input: .pickMultiple(maxItems: 10), mediaKind: .image) // 사진 선택기에서 사진 최대 10장
FrameKitRequest(input: .capture, mediaKind: .image) // 찍은 뒤 편집. .audio면 녹음 뒤 편집도구, 저장 형식, 테마는 요청에 함께 넘깁니다. 테마는 .dark, .light, .system(앱·기기 밝기 설정을 따라 바로 바뀜) 중에서 고릅니다.
FrameKitRequest(
input: .file(url),
image: ImageEditorConfig(enabledTools: [.crop, .rotate]),
imageExport: ImageExportConfig(format: .png, maxWidth: 2048),
ui: EditorUIConfig(themeMode: .system, primaryARGB: 0xFF1E_6BFF)
)앱이 만든 몸짓(왼쪽 가장자리 밀어 닫기 등)으로 편집기를 닫으려면 FrameKitEditorControl을 넘기고 requestClose()를 부릅니다. 닫기 단추와 같이 동작하고(바꾼 내용이 있으면 확인, 저장 중에는 무시), canDismissInteractively로 지금 닫을 수 있는지 알 수 있습니다.
결과 파일은 앱의 Application Support/FrameKit/Exports 안에 저장되고 파일 URL로 옵니다. ShareLink나 UIActivityViewController로 바로 공유할 수 있고, 필요 없어지면 FrameKitOutputs.delete(url)로 지웁니다. 할 일 고르기 시트, 사진·영상 혼합 편집, 앱 전용 필터와 스티커, 편집기별 설정은 iOS 연동 가이드에 있습니다.
Android
READ_MEDIA_IMAGES, READ_MEDIA_VIDEO를 선언했을 때만 열립니다. Google Play 정책상 사진 전체 접근이 핵심 기능인 앱만 선언할 수 있고, 선언하지 않으면 시스템 사진 선택기를 씁니다.RECORD_AUDIO를 선언해야 보입니다. 실시간 문서 스캐너는 CAMERA를 선언했을 때만 쓰고, 아니면 기기 카메라 앱으로 찍습니다.INTERNET 권한이 함께 들어옵니다. 처음 쓸 때 모델을 내려받을 수 있습니다.iOS
invalidConfiguration으로 끝나고 녹음 도구는 보이지 않습니다.| Android | iOS | |
|---|---|---|
| 연동 가이드 | Android 연동 가이드 | iOS 연동 가이드 |
| 설정 | 설정 | iOS 연동 가이드 › 설정 |
| 지원 형식 | 지원 형식 | iOS 연동 가이드 › 지원 형식 |
| 화면 없이 처리 | 화면 없이 처리 | — |
변경 이력은 두 플랫폼을 함께 적습니다.
Apache License 2.0으로 배포합니다. 자세한 내용은 LICENSE를 보세요. 일부 아이콘은 Material Icons를 씁니다(NOTICE).
FrameKit은 Android와 iOS 앱에 사진, 영상, 움직이는 이미지, 음성 편집 화면을 붙이는 SDK입니다. 편집기를 열면 고르기부터 편집, 저장까지 화면이 모두 들어 있고, 앱은 결과 파일만 받으면 됩니다. 원본 파일은 바꾸지 않습니다. 두 플랫폼의 기능과 화면, 결과 형식은 같고, 한쪽에서 쓸 수 없는 기능만 빠져 있습니다.
| Android | iOS | |
|---|---|---|
| 최소 버전 | Android 8.0 (API 26) | iOS 15 |
| 개발 환경 | Kotlin 2.2 이상, Compose 없이도 사용 | Xcode 16 이상, Swift 5·6 |
| 배포 | Maven Central com.naurylab:framekit
|
Swift Package Manager (컴파일된 FrameKit.xcframework) |
| 진입점 |
FrameKitContract (Activity Result) |
.frameKitEditor (SwiftUI), FrameKitViewController (UIKit) |
recorderPresentation).윗줄은 다크 테마, 아랫줄은 라이트 테마입니다.
![]() 사진 편집 |
![]() 문서 스캔 |
![]() 갤러리 |
![]() 영상 편집 |
![]() 움직이는 이미지 |
![]() 녹음 |
![]() 음성 편집 |
![]() 워터마크 |
폴드에서는 이렇게 보입니다.
![]() 사진 편집 도구를 옆 패널에 |
![]() 영상 편집 반쯤 접으면 위는 영상, 아래는 도구 |
![]() 갤러리 폭에 맞춰 늘어나는 격자 |
고르기·사진 편집은 다크 테마, 영상·움직이는 이미지·음성은 라이트 테마입니다.
![]() 고르기 |
![]() 사진 편집 |
![]() 영상 편집 |
![]() 움직이는 이미지 |
![]() 음성 편집 |
상태 바가 옆에 있는 듀오의 덮개 화면에서는 이렇게 보입니다(사진 편집은 다크, 나머지는 라이트).
![]() 사진 편집 오른쪽 상태 바를 피해 배치 |
![]() 영상 편집 타임라인과 도구가 화면 폭에 맞춤 |
![]() 혼합 편집 아래 줄에서 사진과 영상을 오감 |
ios/FrameKit.xcodeproj에서 FrameKitSample을 실행합니다. 편집기별 예제, 결과 보기, 테마·언어·저장 형식을 바꾸는 설정 탭이 들어 있습니다.// settings.gradle.kts
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
}
}
// app/build.gradle.kts
dependencies {
implementation("com.naurylab:framekit:1.0.0-alpha15")
}필요한 편집기만 쓰려면 그 모듈만 넣습니다.
| 모듈 | 내용 |
|---|---|
framekit |
전체 편집기와 통합 진입점 FrameKitContract
|
framekit-ui-image |
사진 편집기 ImageEditorContract
|
framekit-ui-video |
영상 편집기 VideoEditorContract
|
framekit-ui-motion |
움직이는 이미지 편집기 MotionEditorContract
|
framekit-ui-audio |
음성 편집기 AudioEditorContract
|
framekit-picker |
앱 안 갤러리 MediaPickerContract
|
framekit-scanner |
카메라 문서 스캐너 DocumentScanContract
|
framekit-segmentation |
배경 제거 (선택) |
framekit-ocr |
PDF 글자 검색 (선택) |
R8 규칙을 따로 넣을 필요는 없습니다.
Xcode에서 **File › Add Package Dependencies…**를 고르고 아래 주소를 넣습니다. FrameKit 하나에 모든 편집기가 들어 있습니다.
https://github.com/Naury74/Naury-Frame-Kit-SDK
// Package.swift
.package(url: "https://github.com/Naury74/Naury-Frame-Kit-SDK", exact: "1.0.0-alpha15")카메라나 마이크를 쓰는 기능이 있으면 앱 Info.plist에 아래 권한 사용 설명을 추가하세요. 사진·영상 고르기는 시스템 선택기를 써서 사진 접근 권한이 필요 없습니다.
| 키 | 필요한 때 |
|---|---|
NSCameraUsageDescription |
사진 찍기·영상 녹화 |
NSMicrophoneUsageDescription |
영상 녹화, 음성 녹음 |
class MainActivity : ComponentActivity() {
private val editor = registerForActivityResult(FrameKitContract()) { result ->
when (result) {
is FrameKitResult.Success -> show(result.output.uri, result.output.mediaType)
FrameKitResult.Cancelled -> Unit
is FrameKitResult.Failure -> showError(result.error.code)
}
}
// 사용자가 고른 파일 종류에 맞는 편집기가 열린다.
fun edit() = editor.launch(FrameKitRequest(EditorInput.Pick(MediaKind.ANY)))
}입력은 이렇게 고릅니다.
EditorInput.UriSource(uri) // 파일 하나
EditorInput.Multiple(uris.map(EditorInput::UriSource)) // 파일 여러 개
EditorInput.Pick(MediaKind.IMAGE, maxItems = 10) // 갤러리에서 사진 최대 10장
EditorInput.Capture(MediaKind.IMAGE) // 찍은 뒤 편집. AUDIO면 녹음 뒤 편집도구, 저장 형식, 테마는 요청에 함께 넘깁니다.
FrameKitRequest(
EditorInput.UriSource(uri),
image = ImageEditorConfig(enabledTools = setOf(ImageTool.CROP, ImageTool.ROTATE)),
imageExport = ImageExportConfig(format = ImageFormat.PNG, maxWidth = 2048),
ui = EditorUiConfig(themeMode = ThemeMode.LIGHT, primaryArgb = 0xFF1E6BFF.toInt()),
)결과 파일은 앱 내부 저장소에 저장되고 content:// Uri로 옵니다. 다른 앱과 공유할 때는 Intent에 FLAG_GRANT_READ_URI_PERMISSION을 붙이고, 필요 없어지면 FrameKitOutputs.deleteOutput(context, uri)로 지웁니다. 할 일 고르기 시트, 사진·영상 혼합 편집, 문서 스캔, 화면 없이 처리, 앱 전용 필터와 스티커는 Android 연동 가이드에 있습니다.
SwiftUI는 .frameKitEditor 수정자로 띄웁니다.
import FrameKit
struct ContentView: View {
@State private var showEditor = false
var body: some View {
// 사용자가 고른 파일 종류에 맞는 편집기가 열린다.
Button("편집") { showEditor = true }
.frameKitEditor(isPresented: $showEditor, request: FrameKitRequest(input: .pickMultiple(maxItems: 10))) { result in
switch result {
case .success(_, let outputs): show(outputs)
case .cancelled: break
case .failure(let error): showError(error.code)
}
}
}
}UIKit은 FrameKitViewController를 present합니다. 편집기가 스스로 닫힌 뒤 completion을 한 번 부릅니다.
let editor = FrameKitViewController(request: FrameKitRequest(input: .pickMultiple(maxItems: 10))) { result in
if case .success(_, let outputs) = result { show(outputs) }
}
present(editor, animated: true)입력은 이렇게 고릅니다. 고를 종류는 mediaKind(.image, .video, .any, .audio)로 정합니다.
FrameKitRequest(input: .file(url)) // 파일 하나
FrameKitRequest(input: .files(urls)) // 파일 여러 개
FrameKitRequest(input: .pickMultiple(maxItems: 10), mediaKind: .image) // 사진 선택기에서 사진 최대 10장
FrameKitRequest(input: .capture, mediaKind: .image) // 찍은 뒤 편집. .audio면 녹음 뒤 편집도구, 저장 형식, 테마는 요청에 함께 넘깁니다. 테마는 .dark, .light, .system(앱·기기 밝기 설정을 따라 바로 바뀜) 중에서 고릅니다.
FrameKitRequest(
input: .file(url),
image: ImageEditorConfig(enabledTools: [.crop, .rotate]),
imageExport: ImageExportConfig(format: .png, maxWidth: 2048),
ui: EditorUIConfig(themeMode: .system, primaryARGB: 0xFF1E_6BFF)
)앱이 만든 몸짓(왼쪽 가장자리 밀어 닫기 등)으로 편집기를 닫으려면 FrameKitEditorControl을 넘기고 requestClose()를 부릅니다. 닫기 단추와 같이 동작하고(바꾼 내용이 있으면 확인, 저장 중에는 무시), canDismissInteractively로 지금 닫을 수 있는지 알 수 있습니다.
결과 파일은 앱의 Application Support/FrameKit/Exports 안에 저장되고 파일 URL로 옵니다. ShareLink나 UIActivityViewController로 바로 공유할 수 있고, 필요 없어지면 FrameKitOutputs.delete(url)로 지웁니다. 할 일 고르기 시트, 사진·영상 혼합 편집, 앱 전용 필터와 스티커, 편집기별 설정은 iOS 연동 가이드에 있습니다.
Android
READ_MEDIA_IMAGES, READ_MEDIA_VIDEO를 선언했을 때만 열립니다. Google Play 정책상 사진 전체 접근이 핵심 기능인 앱만 선언할 수 있고, 선언하지 않으면 시스템 사진 선택기를 씁니다.RECORD_AUDIO를 선언해야 보입니다. 실시간 문서 스캐너는 CAMERA를 선언했을 때만 쓰고, 아니면 기기 카메라 앱으로 찍습니다.INTERNET 권한이 함께 들어옵니다. 처음 쓸 때 모델을 내려받을 수 있습니다.iOS
invalidConfiguration으로 끝나고 녹음 도구는 보이지 않습니다.| Android | iOS | |
|---|---|---|
| 연동 가이드 | Android 연동 가이드 | iOS 연동 가이드 |
| 설정 | 설정 | iOS 연동 가이드 › 설정 |
| 지원 형식 | 지원 형식 | iOS 연동 가이드 › 지원 형식 |
| 화면 없이 처리 | 화면 없이 처리 | — |
변경 이력은 두 플랫폼을 함께 적습니다.
Apache License 2.0으로 배포합니다. 자세한 내용은 LICENSE를 보세요. 일부 아이콘은 Material Icons를 씁니다(NOTICE).