
지난 몇 주간 iOS 16 공개 베타를 사용해 왔어요. 상당히 안정적이라는 것이 좋았어요. 하지만 일상적으로 사용하는 데 많이 다르지는 않다고 솔직히 말하면, 세 가지 정말 중요하고 정말 멋진 변화를 제외하고요.

## 햅틱 타이핑

첫 번째로 타이핑할 때 햅틱 피드백을 받을 수 있다는 것이에요. 많은 안드로이드 기기들이 오랜 시간동안 가지고 있었던 기능이죠. 그리고 애플이 여러 해 동안 아이폰에 햅틱 엔진을 넣어 뒀을 뿐만 아니라, 아마도 최고의 햅틱 엔진이라고 말할 수 있을 정도로 놀랍게 좋은 엔진인데, 이 기능을 제공하지 않았다는 것이 정말 이상한 것이죠. 당신은 아마 귀하의 강점을 자랑해야 할 것입니다, 맞나요? 그런데 iOS 16에서도 이 새로운 기능이 기본적으로 켜져 있진 않아요. 설정에서 켜야 해요.

그리고 꼭 해야 해요, 왜냐하면 정말 좋으니까요. 이런 것 중 하나는 한 번 켰다면 그 기능이 없는 기기로 갈아타기 힘들어질 거예요. 아주 좋아요. 제가 이런 게 불가능한 기기로 타이핑하는 것을 계속 하고 있기 때문에 알아요. 제 아이패드 미니에는 이런 엔진이나 기능이 없어서 뭔가 고장난 것 같아요. 아마도 애플이 이 기능을 기본적으로 켜지 않게 하는 이유일 거에요. 다른 애플 기기에서 글래스 타이핑이 망가지기 때문일 수도 있어요.

<div class="content-ad"></div>

음향과 함께 사용하는 것도 좋을 것 같아요. 즉, 음향을 켜는 거죠. 제 핸드폰은 거의 항상 소리 없이 조용한데요, 그렇지만 iOS 키보드의 가짜 "클릭" 소리를 오래 사랑해왔어요. 그 소리만 켜놓고 싶은 마음이 들었죠. 이제 진동 피드백도 더 원하게 됐어요. 기기에서 타이핑하는 게 거의 재미있어지니까요. 살짝 까다로운 느낌이에요.

## 아름다운 잠금 화면

iOS 16의 두 번째 슈퍼 기능은 정말 대단해요. 새로운 잠금 화면은 정말 놀라워요. 앤드로이드가 수년 동안 더 많은 사용자 정의 기능을 갖고 있었고 아직도 가지고 있지만, 애플은 첫 번째 시도에서 이를 완벽하게 성취해냈어요. 정말 대단한 거죠.

사실, 애플 워치로부터 많은 것을 빌려온다면 이게 큰 놀라움이 아니겠죠? 비슷한 규칙을 가진 애플 워치는 상당히 획기적이에요. 애플은 기능 및 한계에서 파생되는 폼으로 애플 워치를 위한 UI를 만들었어요. 하지만 이것들은 규모를 키워도 아주 훌륭하게 작동해요. 정보 표시는 훌륭해요. 아직 베타 단계에서는 다양성이 제한적이긴 하지만, 사진의 주제에 대한 초점과 시간을 겹쳐 표시하는 것이 멋지게 보이거든요. 그리고 이 깊이 효과는 화면이 밝아질 때 먼저 주제가 화면에 나오게 해요. 정말 멋지죠.

<div class="content-ad"></div>

또한 놀라운 것은 새로운 타이포그래피 옵션입니다. 보통 같아 보일 수 있지만, 15년 동안 같은 기본 잠금 화면 디자인을 바라보고 있었을 때, 이는 거대한 변화입니다. 색상 옵션도 추가되었고, Apple은 좋은 조합을 제안하는 데 탁월한 일을 합니다. 사랑스럽죠.

날씨(당신이 있는 곳의 현재 날씨를 강조할 수 있습니다), 지구와 달(지구에서 어디에 있는지 또는 어떤 달 상태를 보고 있는지를 보여줍니다), 사진 섞기(사람, 애완동물, 자연, 도시 또는 이들의 조합을 선택할 수 있습니다 - 그리고 네, 전시할 사람을 고를 수 있습니다)가 모두 훌륭합니다.

하지만 실제 쇼의 주인공은 아마도 이른 시기에는 이모티콘일 것 같습니다. 다시 말해, 자신의 강점을 살린다는 개념에 부합하는 Apple은 항상 최고의 이모티콘을 보유하고 있습니다. 그러나 이들이 이모티콘이기 때문에 앱에서 사용할 때는 작아집니다. Apple은 환상적인 디자인을 iOS 16 디자인으로 통합하기로 결정했습니다. 이제 좋아하는 이모티콘을 믹스매치해서 놀랍고 기쁨을 느낄 수 있는 방법으로 사용할 수 있습니다. 그냥 재미있어요.

15년 전 첫 날부터 iPhone 배경 화면을 꾸준히 바꾸는 데 집착하고 있던 한 사람으로서, 이 새로운 기능은 어마어마한 도움이 됩니다. 그리고 Apple이 이 작업을 하는 방법에 놀라운 점이 주로 감명깊습니다.

<div class="content-ad"></div>

하지만 이게 전부가 아니에요.

## 미디어 컨트롤

애플이 음악에 초점을 맞춘 기업이라고 주장하는만큼, 락스크린에서 음악을 재생할 때 아티스트 앨범 아트워크를 작고 작은 칩 형태로 제공하는 것에 대해 오랫동안 비판해왔습니다. 우리에게 거대하고 두드러지는 앨범 아트워크를 주세요. 레코드나 CD 또는 심지어 카세트 테이프를 듣던 시절처럼 말이죠! iOS 16에서 이것이 변경되었고 결과는 훌륭합니다. 마침내요.

배경색을 아트워크와 일치시키는 것은 애플로부터 기대할 만한 섬세한 손길입니다. 또한 원하는 경우 앨범 아트워크를 "최소화"하여 어떠한 이유로든 락스크린 배경화면을 중심으로 유지할 수 있는 것도 좋아요.

<div class="content-ad"></div>

하지만 다른 고려하지 않았던 것 중 하나는 iPhone에서 다른 것을 듣는 데 이 변경사항이 얼마나 더 좋게 만드는지입니다. 예를 들어 팟캐스트에 대한 것인데, 이제 대형 표지 아트로 볼 수 있을 뿐만 아니라, Ben Thompson의 Stratechery와 같이 콘텐츠에 연결된 아트워크가 있는 팟캐스트의 경우 정말 멋집니다. 그림이 얘기되는 내용에 따라 잠금 화면에 크게 나타납니다. The Economist와 같은 경우도 마찬가지입니다. 그들의 앱을 통해 자주 듣는데, 기사 이미지가 듣는 동안 표시됩니다.

마지막으로, iPhone 화면 하단에 제어 기능이 있어서 중앙이 아닌 곳에 위치해 있어서 정말 좋습니다. 엄지손가락으로 쉽게 탐색할 수 있어요.

한 가지 논란이 될 요소는 화면 하단에서 푸시 알림이 들어오는 것입니다. 잠금 화면에서도 나쁘지 않으나, iOS 기본 UI를 사용할 때는 약간 다르게 느껴집니다. 우리는 모두 푸시 알림 영역을 보기 위해 아래로 스와이프해야 하는데, 여전히 작동하지만 이제 스와이프 다운 후에 위로 스와이프해야 합니다. 약간 복잡하죠.

- 이러한 잠금 화면 중 하나를 특정 포커스 설정으로 설정할 수도 있습니다. 아직 그것을 하지는 않았지만, 모두 꽤 똑똑하고 설정하고 편집하기 아주 쉽습니다.


iOS 16을 훌륭하게 만드는 3가지 기능


# 소개

이 글에서는 수학 함수를 소프트웨어 공학에 구현하는 방법을 살펴보고, GaugeViewXK라는 사용자 지정 UIKit 뷰로 변환할 것입니다. 이 뷰는 속도계나 다른 측정 기기에서 찾을 수 있는 게이지를 표시하는 데 사용됩니다. 코드를 분해하고 그 요소들과 논리를 간단한 용어로 설명할 것입니다. 이 안내서는 Swift에서 그리기 API에 대해 더 알고 싶어하는 중/시니어 개발자를 대상으로 합니다.

이 구성 요소를 구축하는 동안, 우리의 목표는 완벽한 구성 요소를 만드는 것이 아니라, 이를 사용해 API 및 Swift-iOS에서 뷰를 그리는 방법을 탐구하는 것입니다.

![이미지](https://miro.medium.com/v2/resize:fit:1400/1*t6RaEGaFpxRyrgEMzCdQ2Q.gif)

<div class="content-ad"></div>

# 목적

GaugeViewXK는 게이지 위에 값의 범위를 시각적으로 나타내기 위해 만들어졌습니다. 그라데이션 색상, 다양한 값에 대한 레이블, 원활하게 목표 값을 향해 움직이는 동적 인디케이터와 같은 기능이 포함되어 있습니다. 목표는 정보를 제공하고 시각적으로 매력적인 게이지 뷰를 만드는 것입니다.

# 구현 방법

- CAShapeLayer 및 CAGradientLayer: 이러한 Core Animation 레이어는 게이지 및 그 구성 요소를 그리고 애니메이션하는 데 사용됩니다.
- CADisplayLink: 게이지 인디케이터를 부드럽게 애니메이션하기 위해 사용됩니다.

<div class="content-ad"></div>

# 도전적인 부분

- 지표 애니메이션:

- 도전점: 지표를 부드럽고 정확하게 대상 값으로 이동시키는 것은 정확한 타이밍과 화면 새로고침 속도와의 동기화를 필요로 합니다. 도전점은 특히 대상 값이 자주 변경될 때 애니메이션이 부자연스럽거나 일관성이 없어지지 않도록 하는 데 있습니다.
- 우리가 한 방법: CADisplayLink를 사용하여 화면의 새로고침 속도와 동기화하는 디스플레이 링크를 만들었습니다. 이를 통해 지표가 위치를 부드럽고 일관되게 업데이트할 수 있도록 했습니다. 현재 값과 대상 값 사이의 차이를 계산하고 지표의 위치를 점진적으로 업데이트하여 부드러운 애니메이션을 구현했습니다.

2. 게이지와 레이블 그리기:

<div class="content-ad"></div>

- 왜 도전적인가: 게이지를 그리는 것은 값의 범위를 나타내는 정확한 호를 만드는 것을 포함합니다. 또한, 이 호 위의 레이블을 정확하게 배치하려면 각도와 위치를 올바르게 계산해야 합니다. 도전 과제는 레이블이 고르게 간격을 두고 게이지에 올바르게 정렬되도록 하는 것입니다.
- 우리가 한 방법: 우리는 삼각법을 사용하여 게이지 호 위의 레이블 위치를 계산했습니다. 각도를 라디안으로 변환하고 사인 및 코사인 함수를 사용하여 각 레이블의 (x, y) 좌표를 결정했습니다. 이를 통해 레이블이 고르게 분포되고 게이지의 해당 값과 정렬되도록 보장했습니다. 또한 CAShapeLayer 및 CAGradientLayer를 활용하여 게이지를 그리고 적절한 색상 또는 그라데이션을 적용했습니다.

# Display Link란 무엇인가요?

CADisplayLink는 앱이 그림을 디스플레이의 새로 고침 속도에 동기화할 수 있게 해주는 타이머 객체입니다. 디스플레이의 새로 고침 속도에 따라 메소드를 호출하여 부드러운 애니메이션을 보장합니다.

# 게이지 그리기

<div class="content-ad"></div>

게이지는 CAShapeLayer와 CAGradientLayer를 사용하여 값을 나타내는 다채로운 호를 그립니다.

- 호 경로: UIBezierPath를 사용하여 중심, 반지름, 시작 각도 및 종료 각도를 지정하여 호 경로를 생성합니다.
- 모양 레이어: CAShapeLayer는 호 경로를 그리는 데 사용됩니다. 게이지 색상 구성에 따라 단일 색상을 적용하거나 CAGradientLayer를 사용하여 그라데이션을 생성합니다.

게이지의 모양은 다양한 색상 또는 그라데이션으로 사용자 정의할 수 있으며 두께는 gaugeWidth 속성으로 제어됩니다.

# 레이블 그리기

<div class="content-ad"></div>

게이지 주변에는 특정 값들을 나타내는 레이블이 그려집니다.

- 레이블 생성: 각 값에 대해 UILabel이 생성되고 계산된 좌표에 배치됩니다. 레이블은 labelFont 및 labelColor 속성에 따라 중앙 정렬되고 스타일이 적용됩니다.
- 레이블 위치 지정: 레이블의 위치를 게이지의 호를 따라 계산합니다. 이를 위해 각 레이블의 각도를 결정하고 삼각함수를 사용하여 호 위의 (x, y) 좌표를 찾습니다.

이로써 레이블이 균등하게 분포되고 게이지상 해당 값과 정렬되도록 보장됩니다.

# 지시자 그리기

<div class="content-ad"></div>

지시자 바늘은 게이지의 현재 값으로 향합니다.

- 지시자 레이어: CAShapeLayer를 사용하여 지시자 바늘을 그립니다. 바늘의 위치는 현재 값에 기반하여 게이지의 각도로 매핑되도록 계산됩니다.
- 지시자 애니메이션: CADisplayLink를 사용하여 바늘을 현재 위치에서 대상 값까지 부드럽게 애니메이션합니다. 이 과정은 바늘의 위치를 점진적으로 업데이트하고 각 단계마다 다시 그리는 것을 포함합니다.

# 그라디언트 레이어 만들기

- gradientLayer.type = .conic
  어떤 종류의 페인트를 사용할지 결정합니다. 여기서는 무지개 원 형태인 코닉 그라디언트를 선택합니다.
- gradientLayer.startPoint = CGPoint(x: 0.5, y: 0.5)
  그림을 시작할 캔버스의 중심을 선택합니다. 이는 사각형의 중앙점입니다.
- gradientLayer.endPoint = CGPoint(x: 0.23, y: 2)
  페인트가 끝날 곳을 설정합니다. 이 지점은 중앙 밖에 약간 있어서 그라디언트에 방향성을 부여합니다.
- gradientLayer.locations = calculateGradientLocations(for: colors)
  각 색상이 그라디언트에 어디에 배치될지 계산합니다. 특정 지점에 스티커를 붙이는 것과 같습니다.
- gradientLayer.frame = rect
  캔버스에 얼마나 큰 공간을 할당해야 하는지 지정합니다. 우리가 얻은 사각형의 크기입니다.
- gradientLayer.colors = processGradientColors(colors: colors).map { $0.cgColor }
  그리기에 색상을 준비합니다. 각 색상을 캔버스가 이해하는 형식으로 변환하고 순서대로 넣습니다.
- gradientLayer.mask = shapeLayer
  캔버스에 스텐실을 놓습니다. 모양 레이어는 마스크처럼 작용하여 우리가 특정 영역에만 그릴 수 있도록 합니다.

<div class="content-ad"></div>

![Image](/assets/img/2024-08-03-DrawingaGaugeViewwithSwift59oniOS_0.png)

## UIBezierPath이 무엇인가요?

UIBezierPath의 init(arcCenter:radius:startAngle:endAngle:clockwise:) 메서드는 원의 아크를 나타내는 새로운 베지에 경로 객체를 생성합니다. 이 메서드는 사용자 정의 뷰에서 아크를 그리는 데 유용합니다.

## 매개변수

<div class="content-ad"></div>

- arcCenter: 아크의 중심을 정의하는 CGPoint입니다. 이는 아크가 그려질 중심점을 나타냅니다.
- radius: 아크의 반지름을 지정하는 CGFloat입니다. 중심점부터 아크의 어떤 점까지의 거리를 결정합니다.
- startAngle: 아크의 시작 각도를 나타내는 CGFloat로, 라디안으로 표시됩니다. 각도는 단위 원에서 양의 x축을 기준으로 측정됩니다.
- endAngle: 아크의 끝 각도를 나타내는 CGFloat으로, startAngle과 마찬가지로 양의 x축을 기준으로 측정됩니다.
- clockwise: 아크가 그려지는 방향을 나타내는 Bool입니다. True이면 시계 방향으로 아크가 그려집니다.

# CGPoint 계산 설명

```js
let endPoint = CGPoint(
    x: center.x + radius * cos(endAngle - .pi / 2),
    y: center.y + radius * sin(endAngle - .pi / 2)
)
```

- 중심 점
  center: 이것은 지시자 선의 시작점으로, 일반적으로 게이지의 중앙에 있습니다 (indicatorWidth로 조정됨).
- 반지름
  radius: 이것은 지시자 선의 길이로, 게이지 폭의 절반에서 게이지 폭 및 일부 간격을 뺀 것으로 계산됩니다.
- 끝 각도
  endAngle: 이 값은 현재 속도를 기반으로 지시자가 향하는 각도(라디안)입니다. 이 각도는 메서드 내에서 이전에 계산됩니다.
- 삼각함수
  cos (코사인)와 sin (사인)은 각도를 x 및 y 좌표로 변환하는 데 도움이 되는 삼각함수입니다.
  삼각법에서 각도는 일반적으로 양의 x축(0도)에서 시계 반대 방향으로 시작합니다. 그러나 화면에 그리기 위해 각도는 일반적으로 양의 y축(90도)에서 시작하여 시계 방향으로 이동합니다. 이 차이를 보정하기 위해 endAngle에서 π/2(90도)를 뺍니다.
- x 및 y 좌표 계산

<div class="content-ad"></div>

- endPoint의 x 좌표는 다음과 같이 계산됩니다:

```js
center.x + radius * cos(endAngle - .pi / 2)
center.y + radius * sin(endAngle - .pi / 2)
```

- 이는 중심의 x 좌표에서 시작하여, 각도의 코사인에 반지름을 곱한 값에 따라 수평으로 이동한다는 것을 의미합니다.

# 시각화

<div class="content-ad"></div>

- 원을 가정해보세요. 중심이 center에 있는 원이에요.
- 반지름은 중심부터 원의 가장자리까지의 길이에요.
- endAngle은 지시기가 가리키는 방향을 결정해요.
- cos와 sin을 사용하여 이 각을 실제 x와 y 거리로 변환하여 endPoint를 얻어요.

# 실제 예시

만약 (50, 50)에 중심을 두고 반지름이 40인 게이지가 있고, endAngle이 바로 위쪽을 가리키는 것에 해당한다면 (90도 또는 π/2 라디안), 이 계산은 다음과 같을 거예요:

```js
x: 50 + 40 * cos(π/2 - π/2) = 50 + 40 * cos(0) = 50 + 40 * 1 = 90
y: 50 + 40 * sin(π/2 - π/2) = 50 + 40 * sin(0) = 50 + 40 * 0 = 50
```

<div class="content-ad"></div>

그래서, endPoint는 중심에서 오른쪽으로 직접 이동하여 (90, 50)이 되며, 이는 90도 각을 나타냅니다.

이 계산은 속도 값에 따라 지시자가 올바르게 표시되도록 하여 게이지에서 정확한 시각적 표현을 제공합니다.

![image](/assets/img/2024-08-03-DrawingaGaugeViewwithSwift59oniOS_1.png)

# 게이지 뷰를 만드는 것이 재미있고 도전적인 이유

<div class="content-ad"></div>

게이지뷰(GaugeView)와 같은 커스텀 뷰를 만드는 것은 여러 가지 이유로 보상적인 경험이 됩니다:

- 핵심 애니메이션(Core Animation) 학습: CAShapeLayer, CAGradientLayer 및 CADisplayLink와 같은 도구를 사용하여 복잡한 애니메이션과 iOS에서 사용자 정의 그림을 생성하는 실용적인 경험을 얻을 수 있습니다.
- 수학적 응용: 삼각 함수를 적용하여 위치와 각도를 계산하면 추상적인 수학과 실용적인 코딩 간의 간극을 좁힐 수 있습니다.
- 문제 해결: 부드러운 애니메이션과 정확한 레이블 위치 설정과 같은 문제를 해결함으로써 문제 해결 능력과 세부 사항에 대한 주의력을 향상시킬 수 있습니다.
- 시각적 피드백: 부드러운 애니메이션과 동적 업데이트를 통해 보면서 사용자 정의 게이지가 살아 움직이는 모습을 볼 수 있어 즉각적이고 만족스러운 시각적 피드백을 제공합니다.

총론적으로, 게이지뷰를 만드는 것은 고급 Swift 및 iOS 개발 기술을 학습하고 연습하는 데 훌륭한 프로젝트로, 재미있는 교육적인 도전이 될 것입니다.

# 자료

<div class="content-ad"></div>

이 문서에서 다루는 주제에 대한 자세한 정보를 원하시면 다음 자료를 살펴보실 수 있습니다:

- Drawing on iOS (https://developer.apple.com/documentation/uikit/uiview/1622529-draw)
- CADisplayLink (https://developer.apple.com/documentation/quartzcore/cadisplaylink)
- CADisplayLink 및 그 응용 (https://medium.com/@dmitryivanov_54099/cadisplaylink-and-its-applications-bfafb760d738)
- CAShapeLayer (https://developer.apple.com/documentation/quartzcore/cashapelayer)
- CAGradientLayer (https://developer.apple.com/documentation/quartzcore/cagradientlayer)
- UIBezierPath (https://developer.apple.com/documentation/uikit/uibezierpath)
- 삼각함수 (https://www.mathsisfun.com/algebra/trigonometry.html)

소프트웨어 엔지니어링에서 수학 함수의 구현에 관한 이 글을 읽어 주셔서 감사합니다. 이로써 여러분의 궁금증을 자극하고 이 중요한 요소의 복잡성에 대해 관심을 갖게 되었으면 좋겠습니다. 다음 글에서 더 도전적이고 재미있는 주제로 만나 보도록 하겠습니다!

# GitHub

<div class="content-ad"></div>

GitHub 저장소에 전체 구현을 찾아보세요:  
[https://github.com/egzonpllana/SwiftAndMathematicalChallenges/tree/main/GaugeViewXK](https://github.com/egzonpllana/SwiftAndMathematicalChallenges/tree/main/GaugeViewXK)

# 함께 연락해요

- LinkedIn: [https://www.linkedin.com/in/egzon-pllana](https://www.linkedin.com/in/egzon-pllana)
- GitHub: [https://github.com/egzonpllana](https://github.com/egzonpllana)


iOS에서 Swift 59로 게이지 뷰 만드는 방법


안녕하세요 Kotlin 팬 여러분! 👋 오늘은 호출 가능한 참조 연산자로 알려진 ::이라는 흥미로운 연산자에 대해 소개합니다. 이 연산자는 함수, 속성 및 생성자를 코틀린에서 간결하고 가독성 있게 참조할 수 있게 해줍니다. 하지만 :: 연산자가 정확히 무엇일까요? 간단히 말하면, 이미 존재하는 코드 요소에 대한 참조를 만들어주어 고차 함수 및 다른 문맥에서 더 쉽게 작업할 수 있게 해줍니다. 호출 가능한 참조는 특히 고차 함수에서 유용하며 코드를 더 표현력 있고 유지보수 가능하게 만듭니다. 이 글에서는 코틀린에서 호출 가능한 참조의 다양한 유형과 사용법에 대해 살펴보며 이 강력한 기능에 대한 포괄적인 안내서를 제공할 것입니다. 🚀

# 📌함수 참조

:: 연산자의 주요 사용 사례 중 하나는 함수에 대한 참조를 만드는 것입니다. 이를 통해 함수를 매개변수로 전달하거나 다른 함수에서 반환하거나 변수에 저장할 수 있습니다. 이 기능은 특히 함수가 1급 시민으로 여겨지는 함수형 프로그래밍 패러다임에서 유용합니다.

# ✨예제

<div class="content-ad"></div>

다음 예시를 살펴보겠습니다. 여기서는 숫자가 짝수인지 확인하는 함수를 정의합니다:

![image](/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_0.png)

이 예시에서 ::isEven은 isEven 함수에 대한 참조를 만들어서 filter 함수로 전달합니다. 이를 통해 코드가 더 읽기 쉽고 간결해집니다.

# 💡실용적인 사용 사례

<div class="content-ad"></div>

함수 참조를 사용하면 고차 함수를 포함하는 코드를 간편하게 만들 수 있습니다. 예를 들어, 컬렉션과 작업할 때:

![image](/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_1.png)

여기서 String::length은 리스트의 각 요소에 적용되는 String 클래스의 length 속성에 대한 참조입니다.

# 🔖속성 참조

<div class="content-ad"></div>

`::` 연산자는 속성에 대한 참조를 만드는 데에도 사용될 수 있습니다. 이는 속성에 대한 참조가 예상되는 함수에 속성을 전달해야 할 때 유용합니다.

# ✨예시

<img src="/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_2.png" />

이 예시에서 Person::name은 Person 클래스의 name 속성에 대한 참조를 만듭니다. 이를 통해 Person 객체 목록에서 이름을 깔끔하고 읽기 쉽게 추출할 수 있습니다.

<div class="content-ad"></div>

# 💡 실용적인 사용 사례

속성 참조는 데이터 변환을 다룰 때 특히 유용할 수 있습니다:

![image](/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_3.png)

여기서 Person::age는 사람 객체를 나이에 따라 비교하고 정렬하는 데 사용됩니다.

<div class="content-ad"></div>

# 🏗️ 생성자 참조

호출 가능한 참조를 사용하여 생성자를 참조할 수도 있습니다. 이를 통해 생성자를 고차 함수에 인수로 전달하거나 함수 참조가 필요한 다른 상황에서 사용할 수 있습니다.

# ✨예시

<img src="/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_4.png" />

<div class="content-ad"></div>

# 💡 실제 활용 예시

생성자 참조는 팩토리 패턴이나 인스턴스를 동적으로 생성할 때 사용될 수 있습니다:

![Constructor References Example](/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_5.png)

이는 생성자 참조가 코드의 유연성을 향상시킬 수 있는 방법을 보여줍니다.

<div class="content-ad"></div>

# 🔄Bound and Unbound References

함수 참조는 바운드 또는 언바운드가 될 수 있습니다. 바운드 참조는 특정 인스턴스를 가리키는 반면, 언바운드 참조는 그렇지 않습니다. 이 차이는 참조가 다른 맥락에서 어떻게 사용될 수 있는지 이해하는 데 중요합니다.

# ✨예제

![예제 이미지](/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_6.png)

<div class="content-ad"></div>

이 경우 alice::name은 alice 인스턴스의 name 속성에 대한 바운드 참조이며, Person::age는 어떤 Person 인스턴스의 age 속성에 대한 언바운드 참조입니다.

# 💡실용적인 사용 사례

바운드 참조와 언바운드 참조는 이벤트 처리나 콜백 시나리오에서 특히 유용할 수 있습니다:

![UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_7](/assets/img/2024-08-03-UnderstandingtheOperatorinKotlinTheCallableReferenceOperator_7.png)

<div class="content-ad"></div>

이 방식은 코드베이스에서 유연성과 재사용성을 향상시킵니다.

# 📚 결론

Kotlin의 :: 연산자는 호출 가능한 참조를 생성하여 함수, 속성, 생성자의 사용을 간소화하는 강력한 기능입니다. 이 연산자는 특히 고차 함수를 다룰 때 코드 가독성과 유연성을 향상시킵니다. 호출 가능한 참조를 이해하고 활용함으로써, 개발자는 보다 간결하고 유지보수가 쉬운 Kotlin 코드를 작성할 수 있습니다. 컬렉션을 조작하거나 이벤트를 처리하거나 동적으로 객체를 생성하는 경우에도 호출 가능한 참조를 통해 Kotlin 개발 프로세스를 크게 간소화할 수 있습니다. 🚀

호출 가능한 참조를 자세히 살펴보면 Kotlin 코드에서 효율성과 표현력의 새로운 수준을 개척할 수 있습니다.


코틀린 호출 참조 연산자 이해하기 사용법 및 예시


<img src="/assets/img/2024-08-03-EffectivelyFormValidationinAndroidDevelopmentwithKotlin_0.png" />

# 소개

폼은 애플리케이션에서 중요한 요소 중 하나입니다. 적어도 사용하는 모든 앱에는 로그인하거나 등록하기 위한 하나 이상의 폼이 있습니다. 앱의 중요한 부분이라는 것을 알고 있는데, 좋은 폼은 좋은 경험을 가져야 합니다. 예를 들어, 폼에 유효하지 않은 문자를 입력할 때 경고가 표시되어야 합니다. Android Studio에서 EditText 구성 요소에서 `setError`를 사용할 수 있습니다. 작은 양의 폼만 필요한 앱에게는 쉬워 보일 수 있습니다. 그러나 앱이 더 복잡해지고 앱 자체가 전체 폼에서 생성된 것일 때, 시간이 지날수록 `setError`를 계속 사용하여 피곤함을 느낄 것입니다. 그래서 폼 유효성 검사를 보다 쉽게 관리할 수 있는 기능이 필요합니다. 또한 간단한 폼만 필요한 앱에게도 매우 유용합니다. 시간을 절약하고 다른 중요한 기능을 만드는 데 집중할 수 있습니다.

# 메소드

<div class="content-ad"></div>

![이미지](/assets/img/2024-08-03-EffectivelyFormValidationinAndroidDevelopmentwithKotlin_1.png)

이 함수의 주요 개념은 함수가 EditText 목록을 받고, 각 항목을 유효성 검사 규칙으로 확인할 것이며, 값이 유효성 검사 규칙을 통과하지 못한 경우 EditText의 오류 속성이 해당 입력 유형에 대한 메시지로 설정될 것입니다. 그래서 이 함수를 만드는 전체 단계는 다음과 같습니다:

## ValidationRules 유형 생성

필수는 아니지만 Map을 사용하는 대신 typealias를 사용하면 더 쉽게 사용할 수 있습니다.

<div class="content-ad"></div>

```js
typealias ValidationRules = Map<EditText, (String) -> Boolean>
```

## Create ValidationHelper object class

Before using the Validation function, you need to define the validation rules you want to apply. For example, you can use regex for email validation. Check out the code snippet below for an example of how to do this.

```js
object ValidationHelper {

    fun email(email: String): Boolean {
        val emailRegex = "^[A-Za-z0-9+_.-]+@(.+)\$"
        return email.matches(emailRegex.toRegex())
    }

    fun username(username: String): Boolean {
        return username.length >= 4
    }

    fun pass(password: String): Boolean {
        return password.length >= 8
    }

    fun matchpass(password: String, confirmPassword: String): Boolean {
        return password == confirmPassword
    }

    fun notempty(input: String): Boolean {
        return input.isNotEmpty()
    }

    fun phone(phoneNumber: String): Boolean {
        val phoneRegex = "^\\d{10,15}\$"
        return phoneNumber.matches(phoneRegex.toRegex())
    }

    fun number(input: String): Boolean {
        return input.toDoubleOrNull() != null
    }
}
```

<div class="content-ad"></div>

인터넷에서 검색하여 직접 유효성 검사 규칙을 만들 수 있어요.

## FormValidator 객체 클래스에 설정 유효성 검사 함수 만들기

이 부분이 중요해요. 헬퍼와 typealias를 만든 후에, 유효성 검사 규칙을 설정하고 EditText에 적용하기 위한 설정 함수가 필요해요.

```js
fun setup(
        forms: List<EditText>,
        validationRules: ValidationRules,
        actionButton: Button
    ) {
        forms.forEach { form ->
            form.doOnTextChanged { text, _, _, _ ->
                val isValid = validationRules[form]?.invoke(text.toString()) ?: false
                form.error = if (isValid) null else getErrorMessage(form, validationRules)
                actionButton.isEnabled = validationRules.all { (form, rule) -> rule(form.text.toString()) }
            }
        }
    }
```

<div class="content-ad"></div>

## 다음으로 getErrorMessage 함수를 사용해보세요

이 함수는 EditText ID를 통해 정의한 사용자 정의 오류 메시지를 가져오는 기능입니다. 실제로 기본 변수를 사용하거나 도우미와 함께 오류 메시지를 결합해서 더욱 효과적으로 사용할 수 있습니다.

```js
private fun getErrorMessage(form: EditText, validationRules: ValidationRules): String {
        return when (form) {
            in validationRules.keys -> when (form.id) {
                R.id.et_email -> "유효하지 않은 이메일 주소입니다"
                R.id.et_username -> "사용자 이름은 적어도 4자 이상이어야 합니다"
                R.id.et_password -> "비밀번호는 적어도 8자 이상이어야 합니다"
                R.id.et_confirm_password -> "비밀번호가 일치하지 않습니다"
                else -> "유효하지 않은 입력입니다"
            }
            else -> "유효하지 않은 입력입니다"
        }
    }
```

## 마지막으로, activity 클래스에서 해당 함수를 사용해주세요

<div class="content-ad"></div>

```kotlin
private fun formValidation() {
        with(binding) {
            val forms = listOf(etEmail, etPassword)
            val validationRules : ValidationRules = mapOf(
                etEmail to { ValidationHelper.email(it)},
                etPassword to { ValidationHelper.pass(it)}
            )
            FormValidator.setup(forms, validationRules, btnLogin)
        }
    }
```

축하합니다! 이제 FormValidation을 사용할 준비가 되었습니다.

# 결론

<img src="/assets/img/2024-08-03-EffectivelyFormValidationinAndroidDevelopmentwithKotlin_2.png" />

<div class="content-ad"></div>

양식은 애플리케이션에서 중요한 요소 중 하나에요. 그래서 효과적인 양식 유효성 검사를 통해 좋은 경험을 제공하는 것이 중요해요. 이를 통해 개발자는 더 쉽고 빠르게 코드를 작성할 수 있어요. 그리고 프로젝트가 끝나면 다음 프로젝트를 시작하고 푹 쉴 수 있어요.


 Kotlin으로 폼 유효성 검사하는 방법


## 리액트 훅 완전 가이드.

![image](https://miro.medium.com/v2/resize:fit:1400/1*HOahzVAKstNAfQwHP6_G3Q.gif)

훅이 소개되기 전에는 클래스 컴포넌트가 상태 및 라이프사이클 메서드를 관리하는 주요 방법이었습니다. 훅은 리액트 16.8 버전에서 소개되었습니다. 클래스와 관련된 다양한 문제를 방지하고 상태와 사이드 이펙트를 보다 간결하고 재사용 가능하게 관리할 수 있습니다.

## 리액트 훅을 사용해야 하는 경우?

<div class="content-ad"></div>

만약 React에서 함수 컴포넌트를 만들고 나중에 상태 또는 부가 효과를 추가해야 한다면, Hooks를 사용할 수 있어요.

## 고려해야 할 Hooks 규칙:

- 먼저 Hooks를 import해주세요.
- Hooks는 함수 컴포넌트 내에서만 사용할 수 있어요.
- Hooks는 함수 컴포넌트의 최상위 레벨에서만 사용할 수 있어요. (컴포넌트 내의 함수 안에 넣을 수 없어요)
- Hooks는 조건문 안에 넣을 수 없어요.

## Hooks 카테고리

<div class="content-ad"></div>

리액트 19 버전까지는 총 20가지 내장 후크가 있습니다. 이 후크들은 목적에 따라 07가지 주요 카테고리로 분류할 수 있어요.

- State Hooks: State 후크는 컴포넌트의 로컬 상태를 유지하는 데 사용될 수 있어요. 사용자 입력과 같은 정보를 기억하는 데 유용해요. useState, useReducer
- Context Hooks: Context 후크는 프롭스로 전달하지 않고 먼 부모 컴포넌트로부터 정보를 전달받는 데 사용돼요. useContext
- Ref Hooks: Ref 후크는 렌더링에 사용되지 않는 일부 정보를 컴포넌트가 보유할 수 있도록 해줘요. DOM 노드나 타임아웃 ID와 같은 것이 이에 해당돼요. useRef, useImperativeHandle
- Effect Hooks: Effect 후크는 컴포넌트가 외부 시스템에 연결하고 동기화할 수 있도록 해줘요. 네트워크, 브라우저 DOM, 기타 React가 아닌 코드 처리를 포함해요. useEffect, useLayoutEffect, useInsertionEffect
- Performance Hooks: 성능 후크는 불필요한 작업을 건너뛰어 다시 렌더링 성능을 최적화하는 데 사용돼요. useMemo, useCallback, useTransition, useDeferredValue
- Form Hooks: 폼 작업을 할 때 사용될 수 있어요. useFormStatus, useFormState
- Other Hooks: useDebugValue, useId, useSyncExternalStore, useActionState, use, useOptimistic

제 유튜브 채널에서는 이 react 후크들을 하나씩 다루게 될 거예요. 그래서 제 채널도 구독해주세요. 그렇게 되면 콘텐츠를 놓치지 않을 거예요.

그리고 React 개발자라면 도움이 될 수 있는 몇 가지 블로그 포스트도 있어요.

<div class="content-ad"></div>

다음 React 블로그를 기다려주세요. 👋👋👋👋

React나 코딩 관련 내용을 배우고 싶다면, 제를 팔로우하는 것을 고려해보세요. 지식을 새롭게 갱신하고 프로그래밍 관련 새로운 정보를 습득할 수 있습니다. 🤩🤩🤩😃


React 19에 새로 추가된 React 훅 정리


SaaS를 혼자 개발자로 만드는 것은 도전적인 과제입니다. 여러 역할을 맡고 다양한 기술에 능숙해야 하며, 기술 스택에 대한 전략적인 결정이 필요합니다. 이는 프런트엔드와 백엔드 모두에 익숙한 풀스택 개발자여야 한다는 것을 의미합니다.

올바른 기술 스택을 선택하는 것은 최고의 개발자 경험을 위해 중요합니다. 이 글에서는 SaaS를 구축하기 위한 Next.js 스택을 공유하고, 스택의 다양한 부분을 자세히 살펴보겠습니다. 또한 저의 신뢰할 수 있는 도구들도 함께 소개할 것입니다. 최종 결과물은 여기 있습니다:

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_0.png)

실시간 데모를 확인해보세요.

<div class="content-ad"></div>

이 게시물이 여러분의 SaaS 여정에 영감을 주고 도움이 되기를 바랍니다.

# Next.js, 스택의 중추

독립 개발자로써 여러분은 쉽게 풀스택 애플리케이션을 구축할 수 있는 프레임워크가 필요합니다. Next.js는 현대적인 애플리케이션을 효율적으로 구축할 수 있도록 도와주는 React 프레임워크로, SaaS를 구축하기에 우수한 선택입니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_1.png)

<div class="content-ad"></div>

Next.js를 사용하여 사용자 대시보드와 마케팅 사이트를 만들고 있어요. 프론트엔드는 React로 작성되었고, 백엔드는 Next.js Route Handlers를 사용하고 있어요. Route Handlers는 RESTful API를 생성해서 React 컴포넌트 및 모바일 애플리케이션과 같은 다른 클라이언트에서 사용할 수 있어요.

마케팅 사이트와 대시보드 모두에 동일한 프레임워크를 사용하면 구성 요소와 스타일을 SaaS의 모든 부분에 재사용할 수 있어요. 이렇게 하면 디자인이 더 일관성 있고 개발이 더 효율적으로 이루어집니다. 마찬가지로, 프론트엔드와 백엔드 모두가 Next.js에 의존하도록 함으로써 두 영역 간에 코드를 공유하는 것이 매우 쉽습니다.

# TypeScript로 한 가지 언어만 사용해요

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_2.png" />

<div class="content-ad"></div>

최대한 생산성을 높이기 위해 저는 TypeScript라는 언어만 사용합니다. Next.js와 결합하여 TypeScript를 사용하면 프론트엔드와 백엔드 코드를 하나의 프레임워크와 언어로 작성할 수 있어 개발 프로세스를 간소화하고 문맥 전환이 줄어듭니다.

# Shadcn UI와 Tailwind CSS

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_3.png)

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_4.png)

<div class="content-ad"></div>

UI로는 Shadcn UI를 선택했어요. Shadcn UI는 Radix UI 위에 구축된 컴포넌트 모음으로, React 컴포넌트를 스타일링하지 않고 제공해요. Shadcn UI는 Tailwind CSS를 사용하여 Radix UI 컴포넌트를 스타일링하여 SaaS에 아름다운 UI를 제공해요. 더 좋은 소식은, 이 컴포넌트를 마케팅 사이트와 사용자 대시보드 사이에서 원활하게 공유할 수 있다는 거예요.

# 인증

인증은 모든 SaaS의 중요한 부분이에요. 저는 Clerk를 사용하여 인증을 처리해요. Clerk는 이메일/비밀번호 및 소셜 로그인과 같은 포괄적인 기능을 제공해요. 이러한 기본적인 기능들은 많은 오픈 소스 라이브러리에서 사용할 수 있어요.

그러나 여러분의 애플리케이션이 더 고급 기능을 필요로 하는 경우, Clerk는 탁월한 선택이에요. Clerk는 다중 요소 인증, 사용자 표시 권한 부여, 다중 세션 지원(한 사용자가 여러 계정에 연결할 수 있음), 일회용 이메일 차단, 브루트포스 방어, 봇 방어 등을 처리할 수 있어요.

<div class="content-ad"></div>

점원은 사용자 정의가 가능한 React에서 완벽한 UI를 제공하여 인증을 제공합니다. 이것은 귀하의 브랜드에 맞추어 사용자 지정할 수 있습니다. 인증을 처음부터 개발하는 수고와 시간을 절약할 수 있습니다. Clerk가 제공하는 내장 UI 중 일부에는 등록, 로그인, 비밀번호 재설정, 비밀번호 초기화 및 사용자 프로필이 포함되어 있습니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_5.png)

# 다중 테넌시 및 팀 관리

강력한 SaaS는 팀 또는 조직 내에서의 협업을 지원해야 합니다. Clerk는 포괄적인 다중 테넌시 및 팀 관리 시스템을 제공하며, 팀을 관리하고 사용자를 초대하는 완벽한 UI를 포함합니다. 이는 Clerk가 초대 이메일을 보내거나 사용자가 팀 간에 신속하게 전환할 수 있도록 하는 것을 포함하여 백엔드 로직이나 팀 관리를 위한 UI를 구현할 필요가 없음을 의미합니다.

<div class="content-ad"></div>

![Role and Permission Image](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_6.png)

# Role and Permission

다중테넌시를 사용할 때는 역할과 권한을 관리하는 것이 중요합니다. Clerk를 사용하면 사용자가 역할을 할당할 수 있는 사용자 정의 역할과 권한을 생성할 수 있습니다. 예를 들어, 관리자는 팀 내에서 모든 권한을 갖지만 읽기 전용 역할은 리소스를 보기만 할 수 있습니다. 이를 통해 적절한 접근 및 보안이 보장됩니다.

![Another Image](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_7.png)

<div class="content-ad"></div>

# 데이터베이스

나는 Drizzle ORM을 데이터베이스 관리에 사용합니다. 이는 타입 안전하며 TypeScript와 완벽하게 통합되기 때문입니다. Drizzle을 사용하면 모델과 관계를 직접 TypeScript에서 정의할 수 있어 외부 스키마 파일이 필요하지 않습니다. 이는 다른 구문을 배울 필요가 없다는 뜻입니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_8.png)

또한 Drizzle는 마이그레이션 프로세스를 간소화하는 CLI 도구인 Drizzle Kit을 제공합니다. Drizzle Kit을 사용하면 데이터베이스 스키마를 쉽게 업데이트할 수 있는 마이그레이션 폴더를 생성할 수 있습니다.

<div class="content-ad"></div>

또한, 데이터베이스를 관리하는 시각적 인터페이스로 Drizzle Studio를 사용할 수 있습니다. Drizzle Studio를 통해 데이터베이스 스키마를 확인하고 쿼리를 실행하며 데이터를 살펴볼 수 있습니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_9.png)

# Stripe

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_10.png)

<div class="content-ad"></div>

Stripe는 결제 및 구독을 원활하게 처리합니다. Stripe SDK를 사용하면 Next.js 애플리케이션에 결제 처리를 쉽게 통합할 수 있습니다. Stripe는 사용자를 리디렉션할 수 있는 결제 페이지를 제공합니다. 이 페이지는 사용자가 구독하려는 요금제를 상기시키는 것뿐만 아니라 매달 또는 매년 청구되는 금액도 보여줍니다. 마지막으로 사용자는 선택한 요금제에 가입하기 위해 신용카드 정보를 입력할 수 있습니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_11.png)

구독이 완료되면 Stripe는 사용자가 가입했다는 신호를 포함하는 웹훅 이벤트를 내 REST API 엔드포인트로 전송합니다. 이를 통해 내 데이터베이스에서 사용자의 구독 상태를 업데이트할 수 있습니다.

Stripe는 사용자가 구독을 관리할 수 있는 자체 서비스 포털을 제공합니다. 이 포털에서 사용자는 요금제를 변경하거나 결제 방법을 업데이트하고 구독을 취소하며 송장을 볼 수 있습니다.

<div class="content-ad"></div>

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_12.png" />

# 국제화 (i18n)

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_13.png" />

글로벌 시장에 다가가기 위해 저는 Next.js에서 여러 언어를 지원하기 위해 Next-Intl 라이브러리를 사용합니다. Next-Intl은 타입 안전한 번역을 제공하여 올바른 번역 키가 사용되었는지 확인합니다. 이를 통해 누락된 또는 잘못된 번역으로 인한 런타임 오류를 방지합니다.

<div class="content-ad"></div>

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_14.png)

번역 경험을 더 효율적으로 만들기 위해 제가 사용하는 Crowdin은 GitHub과 완벽하게 통합되는 로컬라이제이션 플랫폼입니다. Crowdin을 활용하면 번역을 협업적으로 관리할 수 있어 원하는 언어로 애플리케이션이 제공될 수 있습니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_15.png)

# 양식 관리

<div class="content-ad"></div>

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_16.png" />

React-Hook-Form과 Zod을 결합하여 양식 관리 및 유효성 검사를 합니다. React-Hook-Form은 React에서 양식 처리를 간소화하며, Zod는 데이터 유효성을 보장합니다. Zod 스키마는 프론트엔드와 백엔드 간에 데이터 유효성을 확실히 하기 위해 쉽게 공유할 수 있습니다.

# 테스트

SaaS 빌더로서, 응용 프로그램이 예상대로 작동하는지 확인하는 것이 중요합니다. 응용 프로그램을 테스트할 팀이 없으므로 자동화된 테스트에 의존해야 합니다. 이렇게 함으로써 새로운 기능이 추가될 때 응용 프로그램에 재귀적인 문제가 발생하지 않음을 확신할 수 있습니다.

<div class="content-ad"></div>

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_17.png)

유닛 테스트에는 Vitest와 React Testing Library를 사용합니다. Vitest는 TypeScript와 ESM을 기본으로 지원하는 테스트 러너로, Jest의 현대적인 대안을 제공합니다. Vitest의 또 다른 장점은 공식 VSCode 익스텐션과 Vitest UI로, Vitest를 더욱 편리하게 사용할 수 있습니다. 또한, React Testing Library는 React 컴포넌트와 상호 작용하기 위한 유틸리티를 제공합니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_18.png)

최종 사용자 테스트(E2E) 및 통합 테스트에는 Playwright를 사용합니다. Playwright는 브라우저 상호작용을 자동화할 수 있는 강력한 도구로, 애플리케이션의 모든 기능을 테스트하는 데 이상적입니다. Playwright를 사용하면 다양한 브라우저에서 사용자 상호작용을 시뮬레이션하여 앱이 일관되게 작동하는지 확인할 수 있습니다. 또한, Playwright는 Next.js Route Handlers를 테스트하는 데 우수하며, HTTP 요청을 쉽게 보내고 응답을 확인할 수 있습니다.

<div class="content-ad"></div>

# GitHub Actions

GitHub Actions은 지속적 통합(CI)을 위해 사용하는 강력한 도구입니다. 이 도구를 사용하여 코드를 주요 브랜치로 병합하기 전에 테스트 및 확인 프로세스를 자동화할 수 있습니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_19.png)

새로운 커밋을 푸시하거나 풀 리퀘스트를 생성할 때마다 나의 GitHub Actions는 미리 정의한 워크플로우를 자동으로 실행합니다. 이 워크플로우는 Vitest로 단위 테스트를 실행하고, Playwright로 엔드 투 엔드 테스트를 실행하며, 린트 및 코드 서식 맞춤 검사를 수행합니다. 문제가 발생하면 GitHub Actions가 알려주어 잘못된 코드를 병합하는 것을 방지합니다.

<div class="content-ad"></div>

내 코드는 지속적으로 테스트되고 검증되어 안전망을 제공하여 새로운 기능을 구축하는 데 집중할 수 있게 도와줍니다. 특히 솔로 개발자로서 여러 역할을 수행하고 응용 프로그램의 모든 측면을 수동으로 테스트할 시간이 제한적인 상황에서 특히 필요합니다.

# 로깅

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_20.png" />

저는 Node.js용 빠르고 가벼운 로깅 라이브러리인 Pino를 사용합니다. Pino는 메시지를 기록하고 구조화된 로깅을 지원하여 로그를 쉽게 검색하고 분석할 수 있는 간단한 API를 제공합니다. 제품에서는 로깅을 더 나아가 Better Stack으로 로그를 전송하여 실시간 로그 모니터링, 경보 및 시각화를 제공하는 강력한 로깅 플랫폼을 활용합니다. Pino를 Better Stack과 통합함으로써 모든 로그 데이터가 효율적으로 캡처되고 저장되며 접근 가능하게 되어 실시간 환경에서 문제를 신속하게 식별하고 해결할 수 있도록 지원합니다.

<div class="content-ad"></div>

# 에러 모니터링

에러 모니터링을 위해 Sentry를 사용하고 있어요. Sentry는 에러와 예외를 캡처하여 자세한 보고서를 제공해줘요. 이 보고서에는 스택 추적(stack traces), 사용자 컨텍스트(user context) 및 기타 관련 정보가 포함되어 있어 문제를 식별하기 쉽게 해줘요.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_21.png)

로컬 개발 시에는 Spotlight를 사용하여 Sentry 이벤트를 캡처하여, 제품 환경을 압도하지 않고 Sentry의 텔레메트리를 활용하고 있어요.

<div class="content-ad"></div>

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_22.png" />

# 환경 변수

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_23.png" />

T3 Env은 Zod를 사용하여 환경 변수를 유효성 검사하고 변환하는 라이브러리입니다. 이를 통해 모든 환경 변수가 올바르게 정의되고 유효성이 검증됩니다.

<div class="content-ad"></div>

# 린터 및 코드 포매터

깨끗한 코드베이스를 유지하는 것이 중요합니다. 저는 ESLint와 Prettier를 사용하여 린팅 및 코드 포매팅을 합니다. ESLint는 최고의 관행을 강제하고 잠재적인 오류를 잡아내어 코드 품질을 보장하며, Prettier는 일관된 코딩 스타일을 강제함으로써 코드베이스를 더 읽기 쉽고 유지보수하기 쉽게 만듭니다.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_24.png)

저는 ESLint의 기본 구성으로 Airbnb 스타일 가이드를 추천합니다. 그것은 가장 인기 있는 JavaScript 스타일 가이드 중 하나입니다. 게다가, Playwright 테스트가 최상의 관행을 따르도록 보장하기 위해 eslint-plugin-playwright를 사용하고, Tailwind CSS에 대한 최상의 관행을 강제하기 위해 eslint-plugin-tailwind를 사용합니다.

<div class="content-ad"></div>

# VSCode

<img src="/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_25.png" />

비주얼 스튜디오 코드(VSCode)는 제가 선호하는 코드 편집기이며 풍부한 확장 기능 생태계를 갖추고 있습니다. 제 기술 스택과 잘 작동하는 몇 가지 확장 기능을 소개합니다:

- vscode-eslint, ESLint를 VS Code에 통합
- vscode-tailwindcss, Tailwind CSS에 대한 IntelliSense 및 구문 강조 기능 제공
- vscode-github-actions, GitHub Actions 워크플로우를 VSCode에서 직접 관리
- i18n-ally, 국제화를 지원하며 다국어 작업을 보다 쉽게 만드는 번역 키 관리를 제공합니다

<div class="content-ad"></div>

# 결론

요약하면, 혼자 개발자로 SaaS를 구축하는 것은 상당히 어려울 수 있습니다. 그러나 적절한 기술 스택을 선택하면 이 과정을 훨씬 쉽게 만들 수 있어 사용자에게 가치를 전달하는 데 집중할 수 있습니다. 이 글에서 소개된 Next.js, TypeScript, Shadcn UI with Tailwind CSS, Clerk, Drizzle ORM, Stripe 및 기타 도구들의 조합은 SaaS 제품을 구축하기 위한 확장 가능한 환경을 제공합니다.

이 도구들은 개발 프로세스를 단순화할 뿐만 아니라 애플리케이션이 안전하고 효율적이며 사용자 친화적인지도를 보장합니다. 이들은 인증, 다중 테넌시, 결제 처리부터 데이터베이스 관리, 테스트, 지속적 통합까지 모든 것을 처리하여 비즈니스 로직 및 사용자 경험에 집중하는 데 도움을 줍니다.

최종 결과물을 확인하고 싶다면 라이브 데모에서 찾을 수 있습니다.

<div class="content-ad"></div>

저는 Next.js SaaS 보일러플레이트를 만들었어요. 이 보일러플레이트는 이 글에서 소개한 기술 스택을 사용하여 여러분의 SaaS 제품을 구축하기 위한 포괄적인 시작점이에요.

![이미지](/assets/img/2024-08-03-TheUltimate2024TechStackforSoloSaaSDevelopersBuildSmarterNotHarder_26.png)

혼자 개발자로서 성공하기 위한 비결은 올바른 도구와 기술을 활용하는 것이에요. 이 기술 스택은 제 개인적인 선택으로, 제 경험과 요구 사항을 기반으로 선택했어요. 여러분의 프로젝트에 따라 필요한 도구가 다를 수 있지만, 핵심은 변하지 않아요: 여러분이 생산적일 수 있는 도구를 선택하세요.

이 글이 여러분의 SaaS 여정에 대한 통찰력과 영감을 줬으면 좋겠어요. 즐거운 코딩 되세요!


솔로 SaaS를 스마트하고 더 쉽게 구축하는 방법

성능 향상 Faire가 NextJS로 전환한 이유와 방법


![img](/assets/img/2024-08-03-Howtoneverwritecodewithbugs_0.png)

개발자들은 자신의 시간의 75%를 버그 디버깅에 할애하는데, 이것이 주요 이유 중 하나입니다.

이 오류를 피하는 것은 코드에서 발생하는 버그 빈도를 대폭 줄일 수 있습니다.

강력하면서도 간단한 원칙이며 여러 가지 함의가 있습니다.

<div class="content-ad"></div>

절대 코드가 올바르게 작동한다고 가정해서는 안돼요.

그리고 단순히 눈에 보이는 대로만 믿지 말고요...

![Bug image](/assets/img/2024-08-03-Howtoneverwritecodewithbugs_1.png)

머신에도 마찬가지에요.

여기에 자신에게 의존하면 안 된다는 점이 중요해요. 그래서 버그가 처음에 발생하게 되죠.

<div class="content-ad"></div>

버그는 항상 예상치 못한 문제입니다.

특히 복잡한 알고리즘의 경우 디버깅하는 데 많은 시간이 걸립니다.

코드의 논리에 대한 당신의 정신적 모델은 현실과 완전히 달라지는 경우가 많습니다.

보통 코드를 한 줄씩, 변수를 하나씩 주의 깊게 따라가보면 마침내 그 간극을 깨닫게 됩니다.

<div class="content-ad"></div>

자신이 쓴 글을 교정하기가 어려울 수 있는 이유는 동일합니다.

당신의 뇌는 이미 당신이 무엇을 쓰고자 했는지 알고 있습니다. 이미 전달하려는 의미에 대한 정신적 모델을 만들어 놓았습니다. 이것은 실제로 쓰인 것과는 다릅니다.

그래서 당신이 오류를 찾기 위해 작업물을 다시 읽을 때 어떻게 될까요?

낮은 단계의 문법적 및 철자 오류보다 전반적인 의도된 의미에 훨씬 더 집중합니다.

<div class="content-ad"></div>

그래서 코드 리뷰가 중요한 이유입니다 — 코드에 새로운 눈을 통해 여러 번 검토받는 것이 중요합니다.

그래서 정기적인 테스트가 중요합니다.

정기적이고 점진적으로 테스트하면 버그를 빠르고 빠르게 잡을 수 있습니다.

의미 있는 변경을 한다면 즉시 테스트하세요.

<div class="content-ad"></div>

이제 자동화된 테스팅 기술과 지속적 통합 기술이 빛을 발합니다.

수동 테스팅을 하면 테스트를 미루게 되는 경우가 훨씬 많아질 것입니다. 아마도 버그가 넘쳐나는 엄청난 변경을 할 때까지 테스트를 미루게 될 것입니다.

지속적 통합에서는 테스트 미루기에 여지가 없습니다.

정기적으로 커밋하기만 하면 버그 처리 시간을 크게 단축시키고, 뭔가가 엄청난 오류로 이어지는 가능성을 크게 낮출 수 있습니다.

<div class="content-ad"></div>

![image](/assets/img/2024-08-03-Howtoneverwritecodewithbugs_2.png)

# Every Crazy Thing JavaScript Does

Just when you thought you knew all the quirks. Avoid painful bugs and save valuable time with Every Crazy Thing JavaScript Does, a captivating guide to the subtle caveats and lesser-known parts of JavaScript.

Get a free copy here today.

<div class="content-ad"></div>

![How to never overwrite code with bugs](/assets/img/2024-08-03-Howtoneverwritecodewithbugs_3.png)


버그 없는 코드를 작성하기 위해 지켜야하는 7가지


![이미지](/assets/img/2024-08-03-MasteringJavaScriptWebWorkersAnIn-depthGuide_0.png)

안녕하세요 개발자 여러분! 🚀 만일 자바스크립트 코드를 빠르고 효율적으로 만들기 위해 노력 중이라면, 웹 워커(Web Workers)가 여러분의 새로운 친구가 될 수 있을 거예요! 오늘은 웹 앱을 위한 슈퍼히어로 동료같은 멋진 개념에 대해 알아볼 거예요 — 웹 워커(Web Workers). 메인 작업에 집중할 수 있는 동안 모든 번거로운 일을 처리해 주는 도우미가 있다고 상상해 보세요. 바로 웹 워커(Web Workers)가 할 수 있는 일이에요!

# 웹 워커(Web Workers)란 정확히 무엇인가요?

웹 워커(Web Workers)를 여러분의 비밀 에이전트로 생각해 보세요. 이들은 복잡한 계산이나 데이터 처리와 같은 작업을 메인 스레드를 느리게 만들지 않고 백그라운드에서 처리해 주는 요원들입니다. 이는 여러분의 웹 앱이 무거운 작업을 다루더라도 부드럽고 빠른 상태를 유지할 수 있다는 것을 의미합니다.

<div class="content-ad"></div>

![Web Workers](/assets/img/2024-08-03-MasteringJavaScriptWebWorkersAnIn-depthGuide_1.png)

## 웹 워커를 사용해야 하는 이유는?

자바스크립트는 싱글 스레드로 작동하기 때문에 한 번에 한 가지 일만 할 수 있습니다. 메인 스레드에서 긴 작업을 실행할 때 웹 앱이 멈추거나 로딩에 오랜 시간이 걸릴 수 있어 사용자를 기다리게 하고 짜즯거릴 수도 있습니다. 웹 워커는 이러한 작업을 별도의 스레드에서 처리하여 앱이 반응하는 상태를 유지하도록 돕습니다. 그 결과 사용자는 빠른 애플리케이션으로 행복해집니다!

## 약간 실용적으로 생각해 봅시다!

<div class="content-ad"></div>

몇 가지 간단한 단계로 나눠보겠습니다. 그러면 어떻게 작동하는지 이해할 수 있을 거에요!

## 단계 1: 워커 스크립트 생성하기

첫 번째로, 워커를 위한 별도의 JavaScript 파일이 필요합니다. worker.js 또는 당신이 선택한 다른 이름으로 지어봅시다!

worker.js:

<div class="content-ad"></div>

```js
self.onmessage = function (e) {
  const number = e.data;
  const result = fibonacci(number);
  postMessage(result);
};

function fibonacci(n) {
  if (n <= 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}
```

이 파일에서는 self.onmessage를 사용하여 메시지를 수신하고, 피보나치 수 계산과 같은 무거운 작업을 수행한 후 postMessage를 사용하여 결과를 다시 보내는 워커를 설정했습니다.

self가 무엇인지 궁금할 수도 있고, postMessage와 onmessage가 무엇인지 궁금할 수도 있습니다.

웹 워커는 익숙한 창(window)이 아닌 다른 글로벌 컨텍스트에서 작동합니다. 그 특별한 글로벌 컨텍스트를 self라고 부릅니다!

<div class="content-ad"></div>

웹 워커는 이벤트를 사용하여 주 스레드와 통신합니다. 이벤트를 사용하면 메시지나 데이터를 보내고 받을 수 있습니다. 코드에서는 일반적으로 onmessage가 주 스레드로부터 메시지나 데이터를 받아오며, postMessage는 웹 워커에서 처리된 데이터를 주 스레드로 다시 보냅니다.

#### 단계 2: 워커 생성 및 통신하기

이제, 워커를 생성하고 주 스크립트에서 메시지/데이터를 보내는 방법을 살펴봅시다.

main.js:

<div class="content-ad"></div>

```js
// Worker()를 사용하여 새로운 웹 워커를 만듭니다.
const worker = new Worker("worker.js");

// 워커에 데이터를 보냅니다.
worker.postMessage(40); // 40번째 피보나치 수를 계산합니다.

// 워커로부터 데이터를 받습니다.
worker.onmessage = function (e) {
  console.log("결과는:", e.data);
};

// 워커 오류 처리
worker.onerror = function (error) {
  console.error("워커 오류:", error);
};
```

여기서는 Worker()를 사용하여 새로운 워커를 만들고, worker.postMessage로 메시지를 보내고 worker.onmessage로 결과를 받습니다. 또한 worker.onerror로 잠재적인 오류를 처리합니다.

postMessage: 워커로 데이터를 보냅니다.

onmessage: 워커로부터 처리된 데이터를 받습니다.

<div class="content-ad"></div>

onerror: 에러를 처리합니다

# 웹 워커를 활용하는 멋진 방법들

웹 워커는 다양한 시나리오에서 굉장히 유용할 수 있습니다. 몇 가지 실용적인 예제를 살펴보겠습니다.

## 예제 1: 대규모 배열 정렬

<div class="content-ad"></div>

거대한 배열을 정렬하는 데는 많은 시간이 소요될 수 있어요. 웹 워커를 이용해서 그 작업을 처리해보는 건 어때요?

worker.js:

```js
self.onmessage = function (e) {
 const array = e.data;
 array.sort((a, b) => a — b);
 postMessage(array);
 };
```

main.js:

<div class="content-ad"></div>

```js
const worker = new Worker("worker.js");

const largeArray = Array.from({ length: 1000000 }, () => Math.floor(Math.random() * 1000000)); // 데모 시나리오이므로 배열이 동적으로 생성되었습니다.

worker.postMessage(largeArray);

worker.onmessage = function (e) {
  console.log("정렬된 배열:", e.data);
};
```

이 예시에서는 무작위 숫자로 이루어진 거대한 배열을 만들고, 워커에게 정렬을 요청하여 정렬된 배열을 받아옵니다.

## 예시 2: API에서 데이터 가져오기

웹 워커는 주 스레드를 차단하지 않고 API 요청을 처리할 수도 있습니다.

<div class="content-ad"></div>

worker.js:

```js
self.onmessage = async function (e) {
  const url = e.data;
  try {
    const response = await fetch(url);
    const data = await response.json();
    postMessage(data);
  } catch (error) {
    postMessage({ error: "데이터를 가져오지 못했습니다" });
  }
};
```

main.js:

```js
const worker = new Worker("worker.js");

worker.postMessage("https://api.example.com/data");

worker.onmessage = function (e) {
  if (e.data.error) {
    console.error(e.data.error);
  } else {
    console.log("데이터를 가져왔습니다:", e.data);
  }
};
```

<div class="content-ad"></div>

여기에 워커에게 URL을 보내고, 워커가 데이터를 가져와 다시 보내줍니다. 무언가 문제가 발생하면, 워커가 오류 메시지를 보냅니다.

# 웹 워커를 위한 최상의 사례

- 가벼운 상태 유지: 웹 워커는 DOM에 직접 액세스할 수 없으므로 작업을 집중시켜야 합니다.
- 오류 처리: 항상 오류 처리를 포함하여 문제를 감지해야 합니다.

# 웹 워커 시각화

<div class="content-ad"></div>

웹 워커를 공장에서 전문가 팀으로 상상해보세요. 메인 스레드는 매니저이고, 각 워커는 다른 작업을 처리합니다.

![Workers](/assets/img/2024-08-03-MasteringJavaScriptWebWorkersAnIn-depthGuide_2.png)

각 워커는 특정 작업에 집중하여 메인 매니저(스레드)가 전체 그림을 감독하는 데 집중할 수 있도록 합니다.

# 자원

<div class="content-ad"></div>

더 자세한 내용을 알고 싶다면 Web Workers에 관한 다음 리소스를 확인해보세요:

- MDN의 Web Workers
- web.dev의 Web Workers
- W3Schools의 Web Workers

# 마무리

Web Workers는 자바스크립트에서 슈퍼파워를 가지는 것과 같습니다. 무거운 작업을 백그라운드 스레드로 옮겨 웹 앱을 빠르고 반응적으로 유지할 수 있습니다. 다음에 앱이 느려지는 것 같다면, 당신의 슈퍼히어로 곁에 있는 Web Workers가 왔다는 것을 기억하세요!

<div class="content-ad"></div>

행복한 코딩하세요! 🌟

# Stackademic 🎓

끝까지 읽어주셔서 감사합니다. 떠나시기 전에:

- 작성자를 클랩하고 팔로우해주시면 감사하겠습니다! 👏
- 다른 플랫폼 방문하기: In Plain English | CoFeed | Differ
- Stackademic.com에서 더 많은 콘텐츠 확인하기


자바스크립트 웹 워커 개념 정리


![이미지](/assets/img/2024-08-03-Eslint9NextjsSetupGuide_0.png)

# 공통 분모 - 현대 프론트 엔드 스택

새 프로젝트를 시작하거나 기존 프로젝트를 업그레이드할 때는 현재 트렌드를 확인하여 커뮤니티에서 가장 많이 지원하는 기술을 선택하는 것이 좋은 습관입니다.

웹 개발자로서, 가장 인기 있는 프론트엔드 프레임워크인 React, 가장 인기 있는 메타 프레임워크인 Next.js 및 가장 인기 있는 린터인 ESLint을 선택할 가능성이 높습니다. 실제로 React.dev는 Next.js를 권장하며 (프로덕션 등급 및 최신 기능 모두를 위해) Next.js에는 통합된 ESLint가 함께 제공됩니다.

<div class="content-ad"></div>

```js
$ npx create-next-app@latest

성공했습니다! ./my-app에 my-app가 생성되었습니다
```

```js
$ cd my-app && npm outdated
Package       Current    Wanted  Latest  Location                  Depended by
@types/node  20.14.14  20.14.14  22.0.3  node_modules/@types/node  my-app
eslint         8.57.0    8.57.0   9.8.0  node_modules/eslint       my-app
```

# 문제 설명 — Flat 구성 변경

2024년 4월에 ESLint는 새로운 주 버전인 v9.0.0을 출시했습니다. Flat 구성이 이제 기본 구성으로 설정되어 ESLint 사용자, 플러그인 개발자 및 통합자에게 큰 구조적 변경사항입니다. 더 나아지는 거죠?

<div class="content-ad"></div>

![이미지](/assets/img/2024-08-03-Eslint9NextjsSetupGuide_1.png)

평평한 구성은 ESLint를 더 쉽게 접근할 수 있게 하며 명시적 종속성 로딩, 평평한 계단식 규칙, 통합된 형식 등을 통해 예상했던 현대적인 자바스크립트 개발자 경험을 제공합니다. 그러나 이주 과정에서 발생하는 고통 점들은 환영받기 어렵습니다. 이 이주 가이드에 나열된 30개 이상의 급격한 변화가 있습니다. 그리고 위에서 보여주었듯이, Next.js를 선택한 경우 호환성 문제로 ESLint의 이전 버전에 갇힐 수도 있습니다 : Next.js Pull Request #64141을 참조하세요.

# 해결 방안으로 가는 길 — Next.js Opt-out 및 ESLint 이주 도구

우리는 초기 상황을 제시했습니다. 다행스럽게도, ESLint 팀은 여러 이주 도구를 제공하는 데 열심히 노력해 왔습니다. 그러나 가장 간단한 Next.js 프로젝트조차 ESLint 9를 사용하도록 이주하는 것은 많은 문제를 야기합니다. 우리는 해결 방안으로 가는 길을 시연하려 합니다. 계속해서 우리의 my-app을 사용할 것입니다.

<div class="content-ad"></div>

## 저는 ESLint 9을 설치했어요

```js
npm install --save-dev eslint@latest
```

몇 가지 경고가 나왔지만 잘 작동하는 것 같아요. 그런데 확실하게 하기 위해 npm install을 실행해 볼까요?

```js
npm error code ERESOLVE
npm error ERESOLVE could not resolve
...
npm error Conflicting peer dependency: eslint@8.57.0
...
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
```

<div class="content-ad"></div>

--force를 사용하여 npm install을 계속 진행하면 미래에 더 많은 문제를 발생시킬 수 있습니다. 대신, 우리는 의존성 간에 ESLint 특정 버전을 강제해야 합니다.

## II ESLint 버전 재정의

package.json 파일에서 의존성이 사용하는 ESLint 버전을 재정의할 수 있습니다. 이를 통해 위에서 본 충돌을 제거할 수 있습니다.

```js
 {
   ...
   "devDependencies": {
     ...
     "eslint": "^9.8.0",
     ...
   },
+  "overrides": {
+    "eslint": "^9.8.0"
+  }
 }
```

<div class="content-ad"></div>

좋아요, 문제를 해결하는 데 이것이 작동하는지 확인하기 위해 npm install을 실행합시다.

```js
최신 상태, 506ms 내에 352개의 패키지를 감사함

135개의 패키지가 자금 지원을 찾고 있습니다
  세부 정보는 `npm fund`를 실행하십시오

0개의 취약점을 발견함
```

ESLint 9가 제대로 설치되었는데, 린터를 실행할 때 npm run lint를 실행하면 다음과 같은 오류가 발생합니다:

```js
유효하지 않은 옵션:
- 알 수 없는 옵션: useEslintrc, extensions, resolvePluginsRelativeTo, rulePaths, ignorePath, reportUnusedDisableDirectives
- 'extensions'가 제거되었습니다.
- 'resolvePluginsRelativeTo'가 제거되었습니다.
- 'ignorePath'가 제거되었습니다.
- 'rulePaths'가 제거되었습니다. 플러그인을 사용하여 규칙을 정의하십시오.
- 'reportUnusedDisableDirectives'가 제거되었습니다. 대신 'overrideConfig.linterOptions.reportUnusedDisableDirectives' 옵션을 사용하십시오.
```

<div class="content-ad"></div>

이것은 Next.js 통합 ESLint 구성을 사용할 때 next 링크로 인해 발생합니다 (출처).

## III Next.js 통합 ESLint 비활성화

`next.config.mjs` 파일에 다음 라인을 사용하여 통합 ESLint를 쉽게 비활성화할 수 있습니다.

```js
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+  eslint: {
+    ignoreDuringBuilds: true,
+  },
 };

 export default nextConfig;
```

<div class="content-ad"></div>

패키지.json에서 자체 린트 규칙을 선언해야 합니다. 이 규칙은 빌드 규칙에서 사용될 것입니다.

```js
{
 ...
   "scripts": {
     "dev": "next dev",
-    "build": "next build",
+    "build": "npm run lint && next build",
     "start": "next start",
-    "lint": "next lint"
+    "lint": "eslint ."
   },
 ...
 }
```

한 번 더 npm run lint를 시도해 봅시다...

```js
이런! 뭔가 잘못됐어요! :(

ESLint: 9.8.0

ESLint가 eslint.config.(js|mjs|cjs) 파일을 찾을 수 없습니다.

ESLint v9.0.0부터 기본 설정 파일이 이제 eslint.config.js로 변경되었습니다.
만약 .eslintrc.* 파일을 사용하고 있다면, 이전 형식에서
새로운 형식으로 설정 파일을 업데이트하려면 이주 안내서를 따라주세요:

https://eslint.org/docs/latest/use/configure/migration-guide

이주 안내서를 따라도 문제가 계속되면 아래 링크로 방문하여
팀과 채팅해주세요:
https://eslint.org/chat/help
```

<div class="content-ad"></div>

잘하고 있어요! 🙌 이제 새로운 flat config 파일을 만들어볼 수 있는 것 같아요.

## IV .eslintrc.json에서 eslint.config.mjs로 이주

ESLint에서 제공하는 eslint configuration migrator를 사용하여 새로운 flat config 파일을 만들어 봅시다.

```js
npx @eslint/migrate-config .eslintrc.json
```

<div class="content-ad"></div>

아래 Markdown 형식으로 요구된 표 태그를 변경해주세요.

You might be prompted to install new eslint packages, let’s do that.

```js
npm install @eslint/js @eslint/eslintrc -D
```

If you followed step II this should work without any issue and you should get the following eslint.config.mjs file:

```js
import path from "node:path";
import { fileURLToPath } from "node:url";
import js from "@eslint/js";
import { FlatCompat } from "@eslint/eslintrc";

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const compat = new FlatCompat({
  baseDirectory: __dirname,
  recommendedConfig: js.configs.recommended,
  allConfig: js.configs.all,
});
export default [...compat.extends("next/core-web-vitals")];
```

<div class="content-ad"></div>

한 번 더 npm run lint를 실행해 봐요!

```js
앗싸! 뭔가 잘못됐어요! :(

ESLint: 9.8.0

ESLint가 "eslint-plugin-react-hooks" 플러그인을 찾지 못했어요.

("/private/tmp/my-app" 디렉터리에서 Node 모듈로 로드될 때 "eslint-plugin-react-hooks" 패키지를 찾을 수 없었습니다.)

플러그인이 제대로 설치되지 않았을 가능성이 높아요. 아래 명령을 실행하여 다시 설치해 보세요:

    npm install eslint-plugin-react-hooks@latest --save-dev

"eslint-plugin-react-hooks" 플러그인은 " » eslint-config-next/core-web-vitals » /private/tmp/my-app/node_modules/eslint-config-next/index.js"의 구성 파일에서 참조되었어요.

문제를 해결하지 못한다면 https://eslint.org/docs/latest/use/troubleshooting을 참고해 주세요.
```

이번에는 필요한 의존성이 빠졌어요. ESLint가 플러그인 및 기타 종속성을 명시적으로 처리하는 방식이 변경되었기 때문이에요. 지금까지 이러한 것들은 Next.js에서 암시적으로 제공되었지만, 이제는 오류 로그에 설명된 대로 설치해야 해요.

## 누락된 ESLint 의존성 설치하기

<div class="content-ad"></div>

```js
npm install eslint-plugin-react-hooks@latest --save-dev
```

설치는 잘 진행되었지만, 다시 한 번 좋은 진전 🙌 단계를 거치면서 npm run lint를 실행할 때 새로운 종류의 문제가 발생했습니다.

```js
어이쿠! 뭔가 잘못되었어요! :(

ESLint: 9.8.0

TypeError: context.getAncestors is not a function
/private/tmp/my-app/src/app/page.tsx에서 린팅 중 오류 발생:4
규칙: "@next/next/no-duplicate-head"
    at ...
```

ESLint 9의 호환성 문제로 인해 새로운 문제가 발생했습니다. 특히, getAncestors context와 소스 코드 변경과 관련된 문제입니다. 이러한 문제는 상류에서 수정되지 않을 것이며, 대신 ESLint의 호환성 유틸리티를 사용할 것입니다.

<div class="content-ad"></div>

## ESLint 호환 유틸리티 사용하기

우선, 호환 유틸리티를 설치해 봅시다.

```js
npm install @eslint/compat -D
```

이제 우리는 fixupPluginRules 함수에 액세스할 수 있게 되었습니다. 이전 @next/next/no-duplicate-head에서 이슈를 일으킨 플러그인 @next/next를 우리가 이전한 eslint.config.mjs 파일에서 찾게 될 것입니다. 아래 새로운 eslint.config.mjs 파일을 확인해 주세요:

<div class="content-ad"></div>

```js
import path from "node:path";
import { fileURLToPath } from "node:url";
import js from "@eslint/js";
import { FlatCompat } from "@eslint/eslintrc";
import { fixupPluginRules } from "@eslint/compat";

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const compat = new FlatCompat({
  baseDirectory: __dirname,
  recommendedConfig: js.configs.recommended,
  allConfig: js.configs.all,
});

const compatConfig = [...compat.extends("next/core-web-vitals")];

export default compatConfig.map((entry) => {
  const plugins = entry.plugins;
  for (const key in plugins) {
    if (plugins.hasOwnProperty(key) && key === "@next/next") {
      plugins[key] = fixupPluginRules(plugins[key]);
    }
  }
  return entry;
});
```

알았어요, npm run lint 명령어로 다시 테스트해봅시다! 이번에는 잘 동작해야 할 거에요 🎉
코드에서 린트 오류를 발생시킬 수 있는지 확인해야 해요; 예를 들어 컴포넌트 함수 이름을 삭제해볼 수 있어요.

## VII 구성 파일 정리

이제 잘 작동하는 구성 파일이 있으니, 정리하고 새로운 플러그인을 쉽게 추가하여 일반적인 문제를 수정할 수 있도록 리팩터링해봅시다.

<div class="content-ad"></div>

```js
// @ts-check
import path from "node:path";
import { fileURLToPath } from "node:url";
import js from "@eslint/js";
import { FlatCompat } from "@eslint/eslintrc";
import { fixupPluginRules } from "@eslint/compat";

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const compat = new FlatCompat({
  baseDirectory: __dirname,
  recommendedConfig: js.configs.recommended,
  allConfig: js.configs.all,
});

const pluginsToPatch = [
  "@next/next",
  // 다른 수정해야 할 플러그인들, 예시:
  // "react-hooks",
];

const compatConfig = [...compat.extends("next/core-web-vitals")];

const patchedConfig = compatConfig.map((entry) => {
  const plugins = entry.plugins;
  for (const key in plugins) {
    if (plugins.hasOwnProperty(key) && pluginsToPatch.includes(key)) {
      plugins[key] = fixupPluginRules(plugins[key]);
    }
  }
  return entry;
});

const config = [...patchedConfig, { ignores: [".next/*"] }];

export default config;
```

# 마무리 글

이 문제를 해결하는 것은 흥미로웠고, 새로운 문제를 해결하기 위해 훈련된 AI의 한계를 보여줍니다. Linotte에서는 AI에 대해 강력한 Linting 및 정적 분석 전략이 AI 코드 환각을 찾는 데 가장 중요한 안전망 중 하나라고 믿기 때문에 여러분이 그 목표를 달성하는 데 도울 수 있어 기쁩니다!

<img src="/assets/img/2024-08-03-Eslint9NextjsSetupGuide_2.png" />

<div class="content-ad"></div>

ESLint 팀과 Next.js 팀에게 특별한 감사를 전합니다! 두 팀의 노력 덕분에 새로운 최신 도구를 활성화할 수 있는 충분한 유틸리티, 옵션 및 설정이 제공되었습니다!


Posts