macOS용 시청 시계 앱 구축: 종합 가이드-Golang-php.cn

Building a City Hall Clock App for macOS: A Comprehensive Guide

Mac용 멋진 시청 시계 앱을 만들 준비가 되셨나요? 엄청난! 우리는 메뉴 바에 있고, 15분마다 차임벨을 울리고, 심지어 시간까지 계산해주는 앱을 만들 것입니다. 단계별로 나누어서, 무슨 일이 일어나는지 이해할 수 있도록 코드의 모든 부분을 설명하겠습니다.

프로젝트 개요

시청 시계 앱의 기능은 다음과 같습니다.

macOS 메뉴 표시줄에 시계 아이콘 표시
15분마다 차임
매 시간이 시작될 때마다 시간을 알리는 차임
메뉴 표시줄에 "종료" 옵션 제공
터미널 창을 열지 않고도 적절한 macOS 애플리케이션으로 실행

프로젝트 설정

먼저 프로젝트를 설정해 보겠습니다.

새 디렉터리 만들기:

   mkdir CityHallClock
   cd CityHallClock

로그인 후 복사

새 Go 모듈 초기화:

   go mod init cityhallclock

로그인 후 복사

필수 종속성을 설치합니다.

   go get github.com/getlantern/systray
   go get github.com/faiface/beep

로그인 후 복사

주요 코드

이제 main.go 파일을 만들고 각 기능을 살펴보겠습니다.

package main

import (
    "bytes"
    "log"
    "os"
    "path/filepath"
    "time"

    "github.com/faiface/beep"
    "github.com/faiface/beep/mp3"
    "github.com/faiface/beep/speaker"
    "github.com/getlantern/systray"
)

var (
    audioBuffer *beep.Buffer
)

func main() {
    initAudio()
    systray.Run(onReady, onExit)
}

// ... (other functions will go here)

로그인 후 복사

각 기능을 세분화해 보겠습니다.

1. main() 함수

func main() {
    initAudio()
    systray.Run(onReady, onExit)
}

로그인 후 복사

여기서 우리 앱이 시작됩니다. 두 가지 중요한 작업을 수행합니다.

initAudio()를 호출하여 차임벨 사운드를 설정합니다.
시스템 트레이 앱을 실행하여 준비가 되었을 때(onReady), 종료할 때(onExit) 무엇을 해야 할지 알려줍니다.

2. initAudio() 함수

func initAudio() {
    execPath, err := os.Executable()
    if err != nil {
        log.Fatal(err)
    }
    resourcesPath := filepath.Join(filepath.Dir(execPath), "..", "Resources")
    chimeFile := filepath.Join(resourcesPath, "chime.mp3")

    f, err := os.Open(chimeFile)
    if err != nil {
        log.Fatal(err)
    }
    defer f.Close()

    streamer, format, err := mp3.Decode(f)
    if err != nil {
        log.Fatal(err)
    }
    defer streamer.Close()

    audioBuffer = beep.NewBuffer(format)
    audioBuffer.Append(streamer)

    err = speaker.Init(format.SampleRate, format.SampleRate.N(time.Second/10))
    if err != nil {
        log.Fatal(err)
    }
}

로그인 후 복사

이 기능은 오디오를 설정합니다:

저희 앱이 실행 중인 위치를 찾아 차임벨 소리 파일을 찾습니다.
MP3 파일을 열어서 디코딩합니다.
차임벨 소리로 오디오 버퍼를 생성합니다.
오디오 스피커를 초기화합니다.

사운드 파일을 찾을 수 없는 등 문제가 발생하면 오류를 기록하고 종료됩니다.

3. onReady() 함수

func onReady() {
    systray.SetIcon(getIcon())
    systray.SetTitle("City Hall Clock")
    systray.SetTooltip("City Hall Clock")

    mQuit := systray.AddMenuItem("Quit", "Quit the app")

    go func() {
        <-mQuit.ClickedCh
        systray.Quit()
    }()

    go runClock()
}

로그인 후 복사

이 기능은 메뉴 표시줄 아이콘을 설정합니다.

아이콘을 설정합니다(getIcon() 사용).
제목과 툴팁을 설정합니다.
메뉴에 "종료" 옵션을 추가합니다.
"종료" 옵션을 클릭하면 듣기 시작합니다.
시계 실행을 시작합니다(차단되지 않도록 별도의 고루틴에서).

4. onExit() 함수

func onExit() {
    // Cleanup tasks go here
}

로그인 후 복사

앱이 종료될 때 이 함수가 호출됩니다. 여기서는 아무것도 하지 않지만 필요한 경우 정리 작업을 추가할 수 있습니다.

5. runClock() 함수

func runClock() {
    ticker := time.NewTicker(time.Minute)
    defer ticker.Stop()

    for {
        select {
        case t := <-ticker.C:
            if t.Minute() == 0 || t.Minute() == 15 || t.Minute() == 30 || t.Minute() == 45 {
                go chime(t)
            }
        }
    }
}

로그인 후 복사

이것이 우리 시계의 "하트"입니다:

1분마다 "틱"하는 티커를 생성합니다.
무한 루프 속에서 1분마다 시간을 확인합니다.
정시 또는 15분의 1초가 되면 차임벨이 울립니다.

6. 차임() 함수

func chime(t time.Time) {
    hour := t.Hour()
    minute := t.Minute()

    var chimeTimes int
    if minute == 0 {
        chimeTimes = hour % 12
        if chimeTimes == 0 {
            chimeTimes = 12
        }
    } else {
        chimeTimes = 1
    }

    for i := 0; i < chimeTimes; i++ {
        streamer := audioBuffer.Streamer(0, audioBuffer.Len())
        speaker.Play(streamer)
        time.Sleep(time.Duration(audioBuffer.Len()) * time.Second / time.Duration(audioBuffer.Format().SampleRate))

        if i < chimeTimes-1 {
            time.Sleep(500 * time.Millisecond)  // Wait between chimes
        }
    }
}

로그인 후 복사

이 기능은 차임을 재생합니다.

몇 번 차임벨을 울릴지 파악합니다(15분에 한 번, 또는 정각에 몇 번째인지).
그런 다음 차임벨 사이에 짧은 일시정지와 함께 차임벨 소리를 여러 번 재생합니다.

7. getIcon() 함수

func getIcon() []byte {
    execPath, err := os.Executable()
    if err != nil {
        log.Fatal(err)
    }
    iconPath := filepath.Join(filepath.Dir(execPath), "..", "Resources", "icon.png")

    // Read the icon file
    icon, err := os.ReadFile(iconPath)
    if err != nil {
        log.Fatal(err)
    }

    return icon
}

로그인 후 복사

이 기능은 메뉴 표시줄 아이콘을 가져옵니다.

우리 앱이 어디에서 실행되고 있는지 찾아줍니다.
리소스 디렉토리에서 아이콘 파일을 찾습니다.
아이콘 파일을 읽고 해당 내용을 반환합니다.

macOS 애플리케이션 번들 생성

우리 앱을 적절한 macOS 시민으로 만들려면 애플리케이션 번들을 생성해야 합니다. 여기에는 Info.plist 파일 생성이 포함됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>CFBundleExecutable</key>
    <string>CityHallClock</string>
    <key>CFBundleIconFile</key>
    <string>AppIcon</string>
    <key>CFBundleIdentifier</key>
    <string>com.yourcompany.cityhallclock</string>
    <key>CFBundleName</key>
    <string>City Hall Clock</string>
    <key>CFBundlePackageType</key>
    <string>APPL</string>
    <key>CFBundleShortVersionString</key>
    <string>1.0</string>
    <key>CFBundleVersion</key>
    <string>1</string>
    <key>LSMinimumSystemVersion</key>
    <string>10.12</string>
    <key>LSUIElement</key>
    <true/>
    <key>NSHighResolutionCapable</key>
    <true/>
</dict>
</plist>

로그인 후 복사

이를 프로젝트 디렉토리에 Info.plist로 저장하세요.

사용자 정의 아이콘 추가

두 개의 아이콘이 필요합니다:

메뉴 표시줄 아이콘: icon.png라는 22x22 픽셀 PNG를 만듭니다.
앱 아이콘: .icns 파일을 만듭니다.
- 16x16~1024x1024픽셀 크기의 이미지를 만듭니다.
- icon_16x16.png와 같은 이름으로 AppIcon.iconset에 저장하세요.
- 실행: iconutil -c icns AppIcon.iconset

건축 및 포장

빌드 스크립트(build.sh)를 만들어 보겠습니다.

#!/bin/bash

# Build the Go application
go build -o CityHallClock

# Create the app bundle structure
mkdir -p CityHallClock.app/Contents/MacOS
mkdir -p CityHallClock.app/Contents/Resources

# Move the executable to the app bundle
mv CityHallClock CityHallClock.app/Contents/MacOS/

# Copy the Info.plist
cp Info.plist CityHallClock.app/Contents/

# Copy the chime sound to Resources
cp chime.mp3 CityHallClock.app/Contents/Resources/

# Copy the menu bar icon
cp icon.png CityHallClock.app/Contents/Resources/

# Copy the application icon
cp AppIcon.icns CityHallClock.app/Contents/Resources/

echo "Application bundle created: CityHallClock.app"

로그인 후 복사

chmod +x build.sh로 실행 가능하게 만든 다음 ./build.sh로 실행하세요.