흑우마스터의 마법의 공간

meilisearch 우분투+애저 설치 방법

흑우마스터 — Thu, 24 Apr 2025 18:16:35 +0900

curl -L https://install.meilisearch.com | sh

우분투에서 위와 같이 설치 후 다음과 같이 입력

./meilisearch --http-addr 'azure 내부 ip:포트' --master-key='api키'

이러면 실행 가능

만약 dump파일이 존재한다면

rm -rf /home/xcrew/data.ms
./meilisearch --http-addr '아이피:포트' --master-key='api키' --import-dump /home/특정폴더/dumps/덤프파일명.dump

data.ms를 삭제 후 덤프를 추가할 수 있음

.NET MAUI 안드로이드 CarouselView 내 Bitmap 재활용 오류의 원인과 해결 방법

흑우마스터 — Thu, 27 Mar 2025 22:00:55 +0900

.NET MAUI로 앱을 개발하면서 안드로이드 환경에서 CarouselView 내 이미지 컨트롤을 넣고 페이지를 전환하다 보면 다음과 같은 오류가 발생할 수 있다

 Java.Lang.RuntimeException: 'Canvas: trying to use a recycled bitmap android.graphics.Bitmap@f8c1cee'

이 오류는 안드로이드의 Bitmap 객체가 이미 recycle() 메서드를 통해 메모리에서 해제된 이후, 다시 재사용을 시도할 때 발생한다. 특히 CarouselView처럼 이미지가 빠르게 전환되는 경우에 자주 나타나는 문제이다.

.NET MAUI 안드로이드에서는 내부적으로 Glide 또는 유사한 이미지 로딩 라이브러리를 사용하는데, 이들은 로드된 Bitmap을 내부에서 관리하고 재활용(BitmapPool)에 반환하는 구조를 가지고 있다.

이 과정에서 개발자가 Bitmap을 다른 작업에 참조하거나, CarouselView에 반복적으로 그리는 작업을 수행할 경우 충돌이 발생할 가능성이 있다.

.NET MAUI 커뮤니티에서는 이 문제를 해결하기 위해 별도의 핸들러(Handler)를 하라고 해서 해보긴 했다.

#if ANDROID
using Microsoft.Maui.Handlers;
#endif

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        // 기존 코드...

#if ANDROID
        ImageHandler.Mapper.PrependToMapping(nameof(Microsoft.Maui.IImage.Source), (handler, view) =>
        {
            handler.PlatformView?.Clear();
        });
#endif

        return builder.Build();
    }
}

하지만 실제 테스트 결과, 이 방법은 별다른 효과가 없었고, FFImageLoadingImage와 같은 라이브러리를 사용하면 문제가 해결되긴 했으나 이는 근본적인 해결책이라고 보기 어려웠다.

가장 빠르고 확실한 해결 방법은 이미지 컨트롤에 반드시 WidthRequest와 HeightRequest 값을 명시적으로 설정함으로 해결했다. 비트맵이 정확한 크기를 미리 계산하고 할당할 수 있도록 하여 재활용 과정에서 발생하는 오류를 효과적으로 방지하는거라 생각되는데 맞는지는 잘 모르겠다.

다만, 동적인 화면 구성이나 이미지 비율을 유지해야 하는 경우에는 크기를 고정하는 것이 좀 번거로울 수도 있기 때문에 비율에 따라 재계산하는 추가 작업이 필요하다.

MauiReactor 같은 MVU 방식에서는 Render() 또는 Invalidate()를 호출하면 SkiaSharp처럼 Surface가 다시 그려지기 때문에 문제가 덜하지만, 일반 .NET MAUI 환경에서는 추가적인 고민이 필요할 것이다.

추가적으로, 만약 이미지 처리 작업이 더 필요하다면 Bitmap의 복사본을 만들어가면서 교체하는 식도 가능할거 같긴한데 이건 커스텀으로 만들어야 되지만 Glide의 메모리 관리 방식과 독립적으로 안정적인 Bitmap 사용이 가능하니까 꼭 해야 되는 사람이 있다면 커스텀 컨트롤로 만드는 것도 방법이지만 대부분 사이즈를 직접 줄 것 같다.

Cloudflare Bot Fight Mode로 인해 Ably 웹훅이 403 오류를 반환할 때 해결 방법

흑우마스터 — Wed, 5 Mar 2025 13:59:38 +0900

최근 Ably에서 n8n 웹훅을 호출할 때 403 Forbidden 오류가 발생하는 문제를 겪었다.
오류 메시지는 다음과 같았다

message: POST returned HTTP status 403
code: 70002
statusCode: 403
nonfatal: false
href: https://help.ably.io/error/70002
serverId: frontend.efc7.3.us-east-1-A.i-0b9114803583e8c99.e7dDg9szABmY1m

이 오류는 Ably의 공식 문서에서 "웹훅이 허용되지 않았다" 또는 "잘못된 인증 정보" 문제일 가능성이 있다고 안내하고 있다. 하지만 내 경우에는 웹훅이 정상적으로 등록되어 있었고, 인증 문제도 없었다.

원인: Cloudflare Bot Fight Mode

문제의 원인은 Cloudflare의 Bot Fight Mode였다.
Cloudflare는 악의적인 봇 트래픽을 차단하기 위해 Bot Fight Mode를 제공하는데, 이 기능이 활성화된 상태에서는 특정 자동화된 API 요청도 봇으로 오인하여 차단할 수 있다.

결국, Cloudflare의 Bot Fight Mode를 해제하자 Ably 웹훅이 정상적으로 호출되었다.

해결 방법: Cloudflare Bot Fight Mode 해제하기

Cloudflare 대시보드 접속
- Cloudflare 대시보드에 로그인한다.
- 해당 도메인의 설정 페이지로 이동한다.
Bot Fight Mode 설정 변경
- "Security" → "Bots" 메뉴로 이동한다.
- "Bot Fight Mode" 설정을 비활성화(Off) 한다.
설정 저장 후 테스트
- Bot Fight Mode를 해제한 후 Ably에서 다시 웹훅을 호출해본다.
- 정상적으로 응답이 오는지 확인한다.

결론

Cloudflare의 Bot Fight Mode는 자동화된 웹 요청을 차단할 수 있기 때문에, Ably, n8n, Zapier 등의 서비스에서 웹훅을 사용할 때 예기치 않은 403 오류를 유발할 수 있다. 만약 유사한 오류를 경험했다면, Cloudflare의 Bot Fight Mode를 비활성화하는 것이 해결책이 될 수 있다.

[C#] IP 정보 조회 서비스 만들기

흑우마스터 — Wed, 15 Jan 2025 18:15:44 +0900

IP 주소 정보를 조회해야 할 때, 간단한 REST API와 C#의 HttpClient를 활용하면 쉽게 구현할 수 있습니다. 이 포스트에서는 무료로 사용할 수 있는 ip-api 서비스를 활용해 C#으로 IP 정보 조회 서비스를 만드는 방법을 소개합니다.

목표

사용자의 현재 IP 정보 또는 특정 IP 주소의 상세 정보를 가져옵니다.
IP 정보에는 위치(나라, 지역, 도시), 시간대, ISP 정보 등이 포함됩니다.

1. 사전 준비

우선, JSON 데이터를 파싱하기 위해 Newtonsoft.Json 라이브러리를 설치합니다. NuGet 패키지 매니저에서 아래 명령어를 실행합니다.

Install-Package Newtonsoft.Json

2. IpInfo 클래스 정의

IP API의 응답 데이터를 매핑할 클래스를 정의합니다. ip-api에서 반환하는 JSON 데이터를 기반으로 각 속성을 매핑할 수 있습니다. 아래는 IpInfo 클래스의 예입니다:

public class IpInfo
{
    public string Status { get; set; }
    public string Country { get; set; }
    public string CountryCode { get; set; }
    public string Region { get; set; }
    public string RegionName { get; set; }
    public string City { get; set; }
    public string Zip { get; set; }
    public double Lat { get; set; }
    public double Lon { get; set; }
    public string Timezone { get; set; }
    public string Isp { get; set; }
    public string Org { get; set; }
    public string As { get; set; }
    public string Query { get; set; }
}

3. IpService 클래스 작성

IP 정보를 가져오는 주요 로직을 작성합니다. 아래 코드는 HttpClient를 사용하여 IP 정보를 가져오는 서비스 클래스입니다:

public class IpService
{
    private static readonly HttpClient _httpClient;

    static IpService()
    {
        // HttpClient 기본 설정 (Timeout, BaseAddress 등)
        _httpClient = new HttpClient
        {
            Timeout = TimeSpan.FromSeconds(10) // 10초 타임아웃 설정
        };
    }

    /// <summary>
    /// IP 주소 정보를 가져옵니다.
    /// </summary>
    /// <param name="ipAddress">IP 주소 (기본값: 공백, 현재 사용자 IP 사용)</param>
    /// <returns>IP 정보 객체 또는 null</returns>
    public async Task<IpInfo> GetIpInfoAsync(string ipAddress = "")
    {
        try
        {
            string baseUrl = "http://ip-api.com/json";
            string requestUrl = string.IsNullOrWhiteSpace(ipAddress) ? baseUrl : $"{baseUrl}/{ipAddress}";

            // 비동기 요청 및 응답 처리
            string response = await _httpClient.GetStringAsync(requestUrl);
            return Newtonsoft.Json.JsonConvert.DeserializeObject<IpInfo>(response);
        }
        catch (HttpRequestException httpEx)
        {
            // HTTP 요청 관련 예외 처리
            Console.Error.WriteLine($"HTTP 요청 실패: {httpEx.Message}");
        }
        catch (Exception ex)
        {
            // 일반 예외 처리
            Console.Error.WriteLine($"오류 발생: {ex.Message}");
        }

        return null; // 실패 시 null 반환
    }
}

4. 사용 예제

이제 작성한 서비스를 활용하여 IP 정보를 가져오는 간단한 예제를 작성해 보겠습니다.

class Program
{
    static async Task Main(string[] args)
    {
        IpService ipService = new IpService();

        // 현재 IP 정보 조회
        IpInfo myIpInfo = await ipService.GetIpInfoAsync();
        Console.WriteLine($"Country: {myIpInfo.Country}, City: {myIpInfo.City}");

        // 특정 IP 주소 정보 조회
        IpInfo specificIpInfo = await ipService.GetIpInfoAsync("8.8.8.8");
        Console.WriteLine($"Country: {specificIpInfo.Country}, City: {specificIpInfo.City}");
    }
}

5. 결과

위 코드를 실행하면 아래와 같은 결과를 확인할 수 있습니다.

Country: United States, City: Mountain View
Country: United States, City: Mountain View

.NET MAUI에서 Google Map 설정 및 OnMapReady 활용 방법

흑우마스터 — Tue, 14 Jan 2025 16:07:52 +0900

.NET MAUI에서 Google Map을 사용하면서 지도 로딩이 완료된 후 특정 설정을 적용하려면 OnMapReady 메서드를 활용합니다. 이 메서드는 맵이 로드되고 상호작용 준비가 되었을 때 호출됩니다.

Google Map 설정 코드 예제

아래는 OnMapReady 메서드를 활용하여 Google Map의 UI 설정을 조정하는 코드입니다.

using Android.Gms.Maps;
using Android.Gms.Maps.Model;
using Microsoft.Maui.Handlers;
using Microsoft.Maui.Controls.Compatibility.Maps.Android;

class MapCallbackHandler : Java.Lang.Object, IOnMapReadyCallback
{
    private readonly IMapHandler mapHandler;

    public MapCallbackHandler(IMapHandler mapHandler)
    {
        this.mapHandler = mapHandler;
    }

    public void OnMapReady(GoogleMap googleMap)
    {
        // 맵 핸들러를 통해 핀이나 맵 상태를 업데이트
        mapHandler.UpdateValue(nameof(IMap.Pins));
         
        // 줌 컨트롤 버튼 비활성화
        googleMap.UiSettings.ZoomControlsEnabled = false;
         
        // "내 위치" 버튼 비활성화
        googleMap.UiSettings.MyLocationButtonEnabled = false;
         
        // 나침반 비활성화
        googleMap.UiSettings.CompassEnabled = false;
 
        // 추가적으로 틸트(기울기) 제스처나 줌 제스처도 비활성화 가능
        googleMap.UiSettings.TiltGesturesEnabled = false;
        googleMap.UiSettings.ZoomGesturesEnabled = false;
    }
}

OnMapReady 메서드는 Google Map이 완전히 로드된 후 호출됩니다. 이 시점에서 지도 객체(GoogleMap)의 UI 설정이나 상태를 조정할 수 있습니다.

ZoomControlsEnabled
googleMap.UiSettings.ZoomControlsEnabled = false;
줌 버튼을 비활성화합니다.
MyLocationButtonEnabled
googleMap.UiSettings.MyLocationButtonEnabled = false;
"내 위치" 버튼을 비활성화합니다. 이 버튼은 위치 서비스가 활성화되었을 때 표시됩니다.
CompassEnabled
googleMap.UiSettings.CompassEnabled = false;
사용자가 지도를 회전할 때 나타나는 나침반을 비활성화합니다.
TiltGesturesEnabled
googleMap.UiSettings.TiltGesturesEnabled = false;
맵의 기울기 제스처를 비활성화합니다.
ZoomGesturesEnabled
googleMap.UiSettings.ZoomGesturesEnabled = false;
줌 인/줌 아웃 제스처를 비활성화합니다.

iOS 배포 시 문제 해결 : You do not have required contracts to perform an operation You do not have required contracts to perform an operation. (ID: {errorcode}) (403)

흑우마스터 — Tue, 24 Dec 2024 12:56:47 +0900

2024-12-23 11:21:03.893 *** Error: You do not have required contracts to perform an operation You do not have required contracts to perform an operation. (ID: ) (403)
 {
    NSLocalizedDescription = "You do not have required contracts to perform an operation";
    NSLocalizedFailureReason = "You do not have required contracts to perform an operation. (ID: 637d228e-7df6-4652-b156-a9de976e1c43)";
    NSUnderlyingError = "Error Domain=IrisAPI Code=-19241 \"You do not have required contracts to perform an operation\" UserInfo={status=403, detail=You do not have required contracts to perform an operation., id=637d228e-7df6-4652-b156-a9de976e1c43, code=FORBIDDEN_ERROR.CONTRACT_NOT_VALID, title=You do not have required contracts to perform an operation, NSLocalizedFailureReason=You do not have required contracts to perform an operation., NSLocalizedDescription=You do not have required contracts to perform an operation}";
    "iris-code" = "FORBIDDEN_ERROR.CONTRACT_NOT_VALID";
}

앱을 맥에서 배포 하는 단계에서 다음과 같은 오류를 발견했다.

단순하게 클라이언트에서는 인증 자체를 성공했지만 FORBIDDEN_ERROR.CONTRACT_NOT_VALID 에러가 발생한건데

이 문제는 애플 개발자 콘솔에 들어가면 상단에 계약을 갱신해야 된다는 멘트를 발견할 수 있다

저기서 새로 갱신 된 애플 개발자 계약에 대해 수락을 하면 정상적으로 작동한다.

[Supabase + C#] 특정 계정 기간 내 일시 정지 (Ban)

흑우마스터 — Thu, 12 Dec 2024 17:51:43 +0900

await supabaseClient.AdminAuth("어드민 API 키").UpdateUserById("유저 아이디", new Supabase.Gotrue.AdminUserAttributes
{
    BanDuration = "720h" //예시이며 nm ms s m 다 가능하다
});

BanDuration에 "None"을 사용해서 풀기도 가능하다.

이게 왜 안되나 했는데 당연하게도 Admin 으로 로그인 해야지만 가능한 것이었다.

[MAUI] MauiReactor에서 AppLinkRequestReceived 구현

흑우마스터 — Mon, 21 Oct 2024 13:34:41 +0900

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiReactorApp<AppShell>(app => {
            ConfigureAppLink(app);
        });
  }
  
private static void ConfigureAppLink(ReactorApplication app)
{
    app.AppLinkRequestReceived = uri =>
    {
        //이 곳에서 처리 (아래는 예시)
        
        // 전달된 URI에서 파라미터 읽기
    	var queryParams = System.Web.HttpUtility.ParseQueryString(uri.Query);

    	// 원하는 페이지로 네비게이션하거나 파라미터 처리
    	string param = queryParams.Get("paramKey");
    
    	if (!string.IsNullOrEmpty(param))
    	{
        	// 파라미터 기반으로 특정 페이지로 이동
        	Shell.Current.GoToAsync($"//SpecificPage?param={param}");
    	}

    	base.OnAppLinkRequestReceived(uri);
    };
}

앱 링크가 들어오면 이 곳에서 WeakReferenceMessenger나 StrongReferenceMessenger를 Community Toolkit 등을 이용하여서 파라미터를 전달해주고 처리하는 식으로 해결 해야 될 듯함

[MAUI] 구글 맵 지도 확대 시 도로가 검은색으로 표기 되는 문제

흑우마스터 — Tue, 24 Sep 2024 08:02:37 +0900

안드로이드 에뮬레이터가 구버전이거나 SDK가 너무 낮게 되면 구글 맵 확대 시 도로가 검은색으로 표기 되는 문제가 있다.

이건 구글맵이 지도를 업데이트 하면서 색상을 바꿔버린 것이 문제가 되는 것 같다.

문제는 아래처럼 이전 버전의 구글맵을 가지고 있는 에뮬레이터 표기가 정상적이지 않다는 것인데 배포 시에는 별 문제가 없겠지만 작업하는 사람 입장에선 여간 찝찝하지 않을 수가 없다.

이 경우에는 구글 플레이스토어를 지원하는 에뮬레이터로 변경 하고 구글 맵을 업데이트하면 검은색에서 정상적인 화면이 노출 되는 것을 확인할 수 있다.

[MAUI] 오류 ADB0020: Mono.AndroidTools.IncompatibleCpuAbiExceptioniopn: 패키지가 이 장치의 CPU 아키텍처를 지원하지 않습니다.

흑우마스터 — Tue, 24 Sep 2024 07:47:26 +0900

에뮬레이터의 프로세서가 안드로이드 APK와 아키텍처가 같지 않다면 나는 오류로서 디버그나 릴리즈 시에 나는 오류인데 프로젝트 편집에서 아래 코드를 추가하면 정상적으로 돌아간다

<RuntimeIdentifiers Condition="$(TargetFramework.Contains('-android'))">android-arm;android-arm64;android-x86;android-x64</RuntimeIdentifiers>

아래는 ADB에 대한 내용

<AndroidSupportedAbis>armeabi-v7a;x86;x86_64;arm64-v8a</AndroidSupportedAbis>

https://learn.microsoft.com/en-us/dotnet/android/messages/adb0020