Lua Academy · 강의

플러그인 검색과 로딩

디렉터리에서 플러그인 파일을 검색하고 require 또는 loadfile로 불러옵니다.

플러그인 검색과 로딩은(는) CoddyKit의 무료 Lua Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Lua Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

플러그인 아키텍처란 무엇인가요?

플러그인 아키텍처를 사용하면 핵심 부분을 수정하지 않고도 서드파티 코드로 애플리케이션을 확장할 수 있습니다. Lua의 require와 동적 로딩이 이를 자연스럽게 지원합니다.

규칙에 따른 플러그인 탐색

명명 규칙에 맞는 *.lua 파일을 디렉터리에서 검색한 다음 각각을 플러그인으로 로드합니다.

local function discoverPlugins(dir)
  local plugins = {}
  -- platform-specific dir scan; here a mock example
  for _, name in ipairs({"logger", "cache", "auth"}) do
    local ok, mod = pcall(require, dir .. "." .. name)
    if ok then plugins[name] = mod end
  end
  return plugins
end

탐색에 package.path 사용

사용자 지정 디렉터리에서 require가 플러그인을 찾을 수 있도록 package.path를 확장합니다.

package.path = package.path .. ";./plugins/?.lua"
local plugin = require("myplugin")

동적 로딩을 위한 loadfile

loadfile(path)은 Lua 파일을 실행하지 않고 청크로 컴파일합니다. ()을 사용하여 실행하면 플러그인의 모듈 테이블을 얻습니다.

local function loadPlugin(path)
  local chunk, err = loadfile(path)
  if not chunk then return nil, err end
  local ok, result = pcall(chunk)
  if not ok then return nil, result end
  return result
end

플러그인 매니페스트

각 플러그인은 이름, 버전, 의존성을 설명하는 매니페스트 테이블을 내보냅니다.

-- plugins/logger.lua
return {
  name    = "logger",
  version = "1.0",
  deps    = {},
  init    = function(app) app:on("log", print) end,
}

의존성 해결

플러그인을 초기화하기 전에 모든 의존성이 이미 로드되었는지 확인합니다.

local function initPlugin(app, plugins, name)
  local p = plugins[name]
  if not p then error("Plugin not found: " .. name) end
  for _, dep in ipairs(p.deps or {}) do
    if not plugins[dep] then
      error(("Plugin %s requires %s"):format(name, dep))
    end
  end
  if p.init then p.init(app) end
end

플러그인 다시 로드

플러그인을 다시 로드하려면 package.loaded에서 제거하고 require로 다시 로드한 다음 훅을 다시 등록합니다.

package.loaded["plugins.logger"] = nil
plugins.logger = require("plugins.logger")
plugins.logger.init(app)

플러그인 레지스트리

로드된 플러그인의 레지스트리를 유지하여 중복 로드를 방지하고 의존성 검사를 지원합니다.

오류 격리

pcall로 플러그인을 로드하여 문제가 있는 플러그인이 전체 애플리케이션을 중단시키지 않도록 합니다.

local ok, err = pcall(function()
  plugins[name] = loadPlugin(path)
  initPlugin(app, plugins, name)
end)
if not ok then
  print("Plugin load failed:", name, err)
end

플러그인 메타데이터

설명, 작성자, 구성 스키마와 같은 추가 메타데이터를 저장합니다. 이를 UI 표시나 자동 구성에 사용합니다.

지연 로딩

시작할 때 미리 로드하지 않고 플러그인이 처음 필요할 때만 로드합니다. 로딩을 실행하는 __index 메타메서드를 포함한 프록시 테이블로 구현합니다.

플러그인 로딩 질문

플러그인을 로드할 때 pcall을 사용하면 어떤 장점이 있나요?

복습: 플러그인 탐색과 로딩

디렉터리를 검색하거나 명명 규칙을 사용하여 플러그인을 탐색합니다. loadfile 또는 require로 로드합니다. 매니페스트를 검증하고 의존성을 해결합니다. 로드 실패를 항상 격리하려면 pcall을 사용합니다.

자주 묻는 질문

“플러그인 검색과 로딩” 강의는 무료인가요?

네 — “플러그인 검색과 로딩” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Lua Academy 강의 전체를 잠금 해제할 수 있습니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“플러그인 검색과 로딩”에서 뭘 배우나요?

디렉터리에서 플러그인 파일을 검색하고 require 또는 loadfile로 불러옵니다. 브라우저에서 직접 실행하는 실습 코드로 Lua Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Lua Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Lua Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“플러그인 검색과 로딩” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Lua Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Lua Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Lua Academy(으)로 돌아가기