퀵스타터즈
Xamarin을 위한 백엔드 구축 방법?

29min
소개
이 튜토리얼에서는 Back4App의 강력한 기능을 사용하여 Xamarin 모바일 앱의 백엔드를 구축하는 방법을 배웁니다. 
우리는 전용 SDK를 사용하는 대신 Back4App REST API, GraphQL, 및 기타 웹 API 옵션에 의존할 것입니다. 이 접근 방식은 모바일 클라이언트를 가볍고 유연하게 유지하여 간단한 HTTP 호출을 통해 데이터에 연결할 수 있게 합니다.
데이터베이스 모델 생성, 보안 적용, 인증 처리 및 파일 작업 수행에 대해 다룰 것입니다. 
이 단계를 따르면 xamarin의 백엔드를 빠르고 안전하게 구축하는 방법을 알 수 있습니다. 
또한 자동화된 작업 예약 및 webhooks 통합을 탐색하여 Xamarin 앱의 기능을 확장할 수 있으므로 서버 구성에 신경 쓰지 않고 UI 코딩에 집중할 수 있습니다.
이 가이드를 완료하면 mobile apps를 위한 재사용 가능한 템플릿을 갖게 됩니다. 
또한 Access Control Lists (ACLs)을 적용하고, Cloud Code를 작성하는 방법(필요한 경우)과 Live Queries 또는 Cloud Jobs와 같은 고급 워크플로를 최종 솔루션에 통합하는 방법을 이해하게 될 것입니다.
전제 조건
이 튜토리얼을 최대한 활용하려면 다음을 준비하세요:
Back4App 계정
여기에서 무료로 가입하세요.﻿
새 Back4App 프로젝트
Back4app 시작하기﻿
Xamarin 개발 환경 (Visual Studio 또는 Visual Studio for Mac)
Xamarin 설치 문서﻿
C# 및 Xamarin에 대한 기본 지식 (C#의 public class에서 웹 API 요청을 만드는 방법 포함).
이러한 전제 조건이 준비되면, Xamarin 프로젝트를 Back4App에 연결하고 따라갈 준비가 됩니다.
1단계 – Back4App에서 새 프로젝트 만들기 및 연결하기
Back4App 프로젝트 만들기 Back4App 대시보드에서. 이것이 백엔드의 기초입니다.
프로젝트 이름 지정하기 (예: “Xamarin-Backend-Tutorial”).
앱 키 찾기 앱의 “보안 및 키” 섹션으로 이동하여. REST, GraphQL 또는 모바일 클라이언트에서 요청할 때 사용할 수 있는 다른 키를 볼 수 있습니다.
Xamarin 프로젝트 구성하기 HTTP 요청을 만들기 위해. Parse SDK 대신 HttpClient, 또는 선호하는 네트워크 라이브러리를 사용하여 Back4App 앱의 REST 또는 GraphQL 엔드포인트를 호출합니다.
예를 들어, 애플리케이션 ID와 REST API 키를 안전한 장소나 상수 파일에 저장할 수 있습니다:
C#
public class Back4AppConstants
{
    public const string AppId = "YOUR_APPLICATION_ID";
    public const string RestApiKey = "YOUR_REST_API_KEY";
    public const string ServerUrl = "https://parseapi.back4app.com";
}
public class Back4AppConstants
{
    public const string AppId = "YOUR_APPLICATION_ID";
    public const string RestApiKey = "YOUR_REST_API_KEY";
    public const string ServerUrl = "https://parseapi.back4app.com";
}
﻿
웹 API를 호출할 때는 항상 요청 헤더에 이러한 자격 증명을 포함해야 합니다. 이렇게 하면 요청이 필요한 권한으로 올바른 앱으로 라우팅됩니다.
2단계 – 데이터베이스 설정하기
1. 데이터 모델 만들기
Back4App 대시보드를 사용하여 클래스를 정의하거나 첫 요청 시 동적으로 생성되도록 할 수 있습니다. 예를 들어, Todo 클래스를 원하시면 Database 섹션에서 만들거나 REST API 호출을 통해 즉석에서 만들 수 있습니다:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
2. AI 에이전트를 사용한 데이터 모델 만들기
Back4App은 완전한 클래스 구조를 생성할 수 있는 AI 에이전트를 제공합니다:
AI 에이전트를 Back4App 프로젝트에서 엽니다.
모델을 설명합니다 (예: “제목과 isCompleted 필드가 있는 ‘Todo’라는 새 클래스를 만들어 주세요.”).
스키마를 자동으로 생성하도록 확인합니다.
﻿
3. 데이터 읽기 및 쓰기 (REST)
당신의 Xamarin 프로젝트 내에서, public class (예: RestClient)를 작성하여 Back4App에 대한 모든 요청을 처리할 수 있습니다:
C#
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

public class RestClient
{
    private readonly HttpClient _client;

    public RestClient()
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("X-Parse-Application-Id", Back4AppConstants.AppId);
        _client.DefaultRequestHeaders.Add("X-Parse-REST-API-Key", Back4AppConstants.RestApiKey);
    }

    public async Task CreateTodoAsync(string title, bool isCompleted)
    {
        var newTodo = new { title = title, isCompleted = isCompleted };
        var content = new StringContent(JsonConvert.SerializeObject(newTodo), Encoding.UTF8, "application/json");
        var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/classes/Todo", content);
        // Handle the response
    }

    public async Task<List<Todo>> GetTodosAsync()
    {
        var response = await _client.GetAsync($"{Back4AppConstants.ServerUrl}/classes/Todo");
        var jsonString = await response.Content.ReadAsStringAsync();
        // Parse JSON into a C# model (Todo)
        // Return the result
        // ...
        return new List<Todo>(); // Placeholder
    }
}

public class Todo
{
    public string objectId { get; set; }
    public string title { get; set; }
    public bool isCompleted { get; set; }
}
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

public class RestClient
{
    private readonly HttpClient _client;

    public RestClient()
    {
        _client = new HttpClient();
        _client.DefaultRequestHeaders.Add("X-Parse-Application-Id", Back4AppConstants.AppId);
        _client.DefaultRequestHeaders.Add("X-Parse-REST-API-Key", Back4AppConstants.RestApiKey);
    }

    public async Task CreateTodoAsync(string title, bool isCompleted)
    {
        var newTodo = new { title = title, isCompleted = isCompleted };
        var content = new StringContent(JsonConvert.SerializeObject(newTodo), Encoding.UTF8, "application/json");
        var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/classes/Todo", content);
        // Handle the response
    }

    public async Task<List<Todo>> GetTodosAsync()
    {
        var response = await _client.GetAsync($"{Back4AppConstants.ServerUrl}/classes/Todo");
        var jsonString = await response.Content.ReadAsStringAsync();
        // Parse JSON into a C# model (Todo)
        // Return the result
        // ...
        return new List<Todo>(); // Placeholder
    }
}

public class Todo
{
    public string objectId { get; set; }
    public string title { get; set; }
    public bool isCompleted { get; set; }
}
﻿
4. 데이터 읽기 및 쓰기 (GraphQL)
GraphQL 쿼리의 경우, Back4App GraphQL 엔드포인트에 요청을 보낼 수 있습니다:
Bash
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-Master-Key: YOUR_MASTER_KEY" \
  --data '{"query":"mutation { createTodo(input:{fields:{title:\"Wash the car\" isCompleted:false}}){ todo{ objectId title }}}"}' \
  https://parseapi.back4app.com/graphql
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-Master-Key: YOUR_MASTER_KEY" \
  --data '{"query":"mutation { createTodo(input:{fields:{title:\"Wash the car\" isCompleted:false}}){ todo{ objectId title }}}"}' \
  https://parseapi.back4app.com/graphql
﻿
유사하게, Xamarin에서 GraphQL 문자열과 함께 JSON 본문을 POST할 수 있습니다 https://parseapi.back4app.com/graphql.
5. 실시간 쿼리 작업하기 (선택 사항)
Parse SDK 대신 웹 API 호출을 사용하고 있지만, 실시간 데이터 업데이트를 원한다면 여전히 실시간 쿼리를 활성화할 수 있습니다. 클래스 변경 사항에 구독하기 위해 전문화된 연결(WebSockets)을 사용해야 합니다. 앱의 서버 설정에서 실시간 쿼리를 활성화한 다음, 가능하다면 Xamarin에서 호환되는 클라이언트 라이브러리를 사용하세요. 또는, 실시간 지원이 선택 사항인 경우 자체 WebSocket 솔루션을 구축하거나 폴링에 의존할 수 있습니다.
3단계 – ACL 및 CLP로 보안 적용하기
1. ACL 및 CLP 개요
Back4App 보안에는 클래스 수준 권한 (CLPs) 및 액세스 제어 목록 (ACLs). CLPs는 어떤 사용자 또는 역할이 전체 클래스에 대해 읽기/쓰기를 할 수 있는지를 정의합니다. ACLs는 객체별 보안을 추가합니다. 이를 결합하여 권한이 있는 사용자만 데이터에 접근할 수 있도록 합니다.
2. 클래스 수준 권한 설정하기
데이터베이스 섹션을 Back4App에서 엽니다.
클래스를 선택합니다 (예: Todo).
클래스 수준 권한으로 이동합니다 읽기/쓰기 규칙을 설정합니다. 인증된 사용자만 읽거나 쓸 수 있도록 허용할 수 있습니다. 이는 모바일 클라이언트가 데이터를 읽기 전에 로그인해야 함을 보장합니다.
4단계 – 클라우드 코드 함수 작성하기
1. 클라우드 코드의 필요성
클라우드 코드는 사용자 정의 서버 측 로직을 실행할 수 있게 해줍니다. 비즈니스 규칙, 유효성 검사 또는 데이터가 변경될 때 실행되는 트리거를 생성할 수 있습니다. 이는 로직이 모바일 클라이언트 외부에서 실행되므로 변조 위험을 줄입니다.
2. 예제 함수 및 트리거
아래는 main.js 파일의 클라우드 함수의 간단한 샘플입니다:
JS
Parse.Cloud.define('helloXamarin', async (request) => {
  return 'Hello from Xamarin Cloud Code!';
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Title is required';
  }
});
Parse.Cloud.define('helloXamarin', async (request) => {
  return 'Hello from Xamarin Cloud Code!';
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Title is required';
  }
});
﻿
3. 배포
배포하려면 Back4App CLI 또는 대시보드의 클라우드 코드 섹션을 사용할 수 있습니다. 배포가 완료되면 Xamarin을 통해 REST:에서 함수를 호출할 수 있습니다.
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://parseapi.back4app.com/functions/helloXamarin
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://parseapi.back4app.com/functions/helloXamarin
﻿
4. NPM 모듈
추가 라이브러리가 필요하면 npm을 사용하여 Cloud Code 프로젝트 폴더에 설치하세요. 그 후, require를 사용하여 main.js에서 불러옵니다. 이 방법은 서버 측에서 서드파티 API를 호출하는 데 유용합니다.
5단계 – 인증 구성
1. 사용자 인증 활성화
Back4App에서 _User 클래스는 사용자 자격 증명을 관리합니다. 앱 설정,에서 사용자 인증, 이메일 확인 및 비밀번호 재설정 설정을 활성화할 수 있습니다.
2. 사용자 가입 / 로그인 (REST)
Xamarin 프로젝트에서 가입 및 로그인을 처리하는 C# 메서드를 작성할 수 있습니다:
C#
public async Task SignUpUserAsync(string username, string password, string email)
{
    var user = new 
    { 
        username = username, 
        password = password,
        email = email 
    };

    var content = new StringContent(JsonConvert.SerializeObject(user), Encoding.UTF8, "application/json");
    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/users", content);
    // Parse response
}

public async Task LogInUserAsync(string username, string password)
{
    var loginEndpoint = $"{Back4AppConstants.ServerUrl}/login?username={username}&password={password}";
    var response = await _client.GetAsync(loginEndpoint);
    // Parse response
}
public async Task SignUpUserAsync(string username, string password, string email)
{
    var user = new 
    { 
        username = username, 
        password = password,
        email = email 
    };

    var content = new StringContent(JsonConvert.SerializeObject(user), Encoding.UTF8, "application/json");
    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/users", content);
    // Parse response
}

public async Task LogInUserAsync(string username, string password)
{
    var loginEndpoint = $"{Back4AppConstants.ServerUrl}/login?username={username}&password={password}";
    var response = await _client.GetAsync(loginEndpoint);
    // Parse response
}
﻿
그런 다음 클라이언트 측에서 세션 토큰을 저장하여 향후 요청에 사용할 수 있습니다.
3. 소셜 로그인
소셜 로그인을 통합하려면 (예: Google, Facebook), Back4App 소셜 로그인 문서. 각 제공자는 고유한 OAuth 흐름을 가지고 있으며, 이를 모바일 클라이언트에서 처리할 수 있습니다. 그런 다음 반환된 토큰을 Back4App에 전달하세요.
6단계 – 파일 저장 처리
1. 파일 저장 설정
파일은 본문에 파일 데이터를 포함한 POST 요청을 보내어 업로드할 수 있습니다. 예를 들어, Xamarin 앱에서 이미지를 저장하려면 이미지를 바이트 배열로 읽은 다음 전송합니다:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary "@local-image.png" \
  https://parseapi.back4app.com/files/myImage.png
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary "@local-image.png" \
  https://parseapi.back4app.com/files/myImage.png
﻿
2. C#를 사용한 예제 업로드
C#
public async Task<string> UploadFileAsync(byte[] fileData, string fileName)
{
    var fileContent = new ByteArrayContent(fileData);
    fileContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("image/png");

    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/files/{fileName}", fileContent);
    var jsonResponse = await response.Content.ReadAsStringAsync();
    // Parse the response to get file URL
    return "File URL from response";
}
public async Task<string> UploadFileAsync(byte[] fileData, string fileName)
{
    var fileContent = new ByteArrayContent(fileData);
    fileContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("image/png");

    var response = await _client.PostAsync($"{Back4AppConstants.ServerUrl}/files/{fileName}", fileContent);
    var jsonResponse = await response.Content.ReadAsStringAsync();
    // Parse the response to get file URL
    return "File URL from response";
}
﻿
3. 보안 고려사항
파일 업로드를 안전하게 하려면 Back4App 서버 설정으로 가서 파일 권한. 예를 들어, 인증된 사용자만 업로드를 허용할 수 있습니다.
7단계 – 이메일 인증 및 비밀번호 재설정
1. 개요
이메일 인증은 사용자가 등록한 이메일을 소유하고 있음을 보장합니다. 비밀번호 재설정 링크는 사용자가 비밀번호를 잊어버린 경우 다시 접근할 수 있도록 합니다.
2. Back4App 대시보드 구성
“이메일 확인”을 이메일 설정에서 활성화하십시오.
“비밀번호 재설정 템플릿”을 편집하고 “보낸 사람” 주소를 설정하십시오.
브랜딩에 맞게 이메일 내용을 사용자 정의할 수도 있습니다.
3. 구현
활성화되면 사용자가 이메일로 가입하면 확인 링크를 받게 됩니다. 비밀번호 재설정 요청은 사용자의 이메일을 사용하여 동일한 기본 API에 호출되어 재설정 이메일을 트리거합니다.
8단계 – 클라우드 작업으로 작업 예약하기
1. 클라우드 작업의 기능
클라우드 작업을 사용하면 Back4App 플랫폼에서 오래된 데이터 정리 또는 매일 요약 이메일 전송과 같은 정기 작업을 예약할 수 있습니다.
2. 예시
JS
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS_AGO = new Date(now - 30 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', THIRTY_DAYS_AGO);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old items.`;
});
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS_AGO = new Date(now - 30 * 24 * 60 * 60 * 1000);
  query.lessThan('createdAt', THIRTY_DAYS_AGO);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old items.`;
});
﻿
클라우드 코드를 배포한 후 앱 설정 > 서버 설정 > 백그라운드 작업에서 작업을 예약하십시오.
9단계 – 웹훅 통합하기
Back4App에서 웹훅을 정의하려면 더보기 > 웹훅로 이동한 후 “웹훅 추가”를 클릭하십시오.
엔드포인트를 제공하십시오,https://your-service.com/webhook-endpoint와 같은.
“Todo 클래스의 새 객체”와 같은 트리거를 선택하십시오.
﻿
웹후크는 제3자 서비스에 알림을 보낼 수 있으므로, Xamarin 앱은 외부 시스템이 추가 로직이나 알림을 처리하는 동안 가볍게 유지될 수 있습니다.
10단계 – Back4App 관리 패널 탐색
“Back4App 관리 앱”은 쿼리를 작성하지 않고 CRUD 작업을 처리할 수 있는 사용자 친화적인 방법입니다. 앱 대시보드 > 더보기 > 관리 앱에서 활성화하세요. 관리 사용자를 생성하고, 하위 도메인을 선택한 후 로그인하세요.
﻿
이 관리 앱은 데이터 관리를 필요로 하지만 데이터베이스에 직접 접근해서는 안 되는 비기술 팀원에게 이상적입니다.
결론
당신은 이제 Back4App API를 사용하여 Xamarin의 백엔드를 구축하는 방법을 보았습니다. 안전한 클래스를 생성하고, CLP와 ACL, 인증을 처리하고, 파일 업로드, 작업 예약 및 외부 서비스와의 통합을 탐색했습니다. 이 접근 방식은 모바일 앱이 호스팅된 데이터베이스와 클라우드 환경의 힘을 활용하면서 빠르고 유연하게 유지되도록 보장합니다.
다음 단계
Xamarin 애플리케이션을 확장하여 더 복잡한 로직, 캐싱 또는 고급 역할 및 권한을 처리하세요.
고급 기능에 대해 깊이 파고들기, 푸시 알림과 같은 기능이나 협업 업데이트가 필요한 경우 실시간 데이터와 Live Queries를 통합하세요.
공식 Back4App 문서 방문하기 보안, 성능 및 디버깅에 대한 심층 가이드를 위해.
실제 솔루션 만들기 제3자 API(결제 게이트웨이, 분석, 소셜 미디어)와 Back4App 백엔드를 혼합하여. 이 조합은 모바일 클라이언트의 기능을 향상시키고 코드를 정리하는 데 도움이 될 수 있습니다.
﻿
업데이트됨 24 Jan 2025
이 페이지가 도움이 되었습니까?
PHP를 위한 백엔드 구축 방법은?
리액트 네이티브를 위한 백엔드 구축 방법?