跳到主要内容

The Packaging Process for Answer Plugins

LinkinStar
阅读需 3 分钟
  1. Why is Answer's plugin system designed in such a way that it seems a bit of difficulty to use?
  2. How can I implement plugin functionality using Golang?
  3. What exactly does Answer's plugin system do when it is compiled and packaged?

Background

You can build a Q&A community using answer easily. However, the basic features of Answer may not sufficiently support to every use case. Therefore, we need to design a plugin system to extend its features. As you may know, Answer is built using React.js and Golang. Both these languages require compilation. So designing a plugin system is a bit difficult.

Goal & Features

The goal of Answer's plugin system is to provide a flexible and extendable architecture that can accommodate a wide range of use cases. Some of the key features of the plugin system include:

Connectors

By default, Answer supports login via email and password. Withing the plugin system, developers can easily integrate other authentication, such as GitHub.

install-choose-language

Storage

Out of the box, Answer stores files in the local file system. However, there could be scenarios where users might prefer to save their uploaded files to a cloud storage service like S3. This can be achieved by plugin system.

install-choose-language

Implementation

Now, let's explore how the plugin system is implemented, followed by the reasons behind our design decisions.

Details

The general process is as follows:

install-choose-language

Here are the steps involved in implementing a plugin:

  1. Generate a main.go file.
  2. Import the specific plugin list.
  3. Execute go mod tidy and go mod vendor to manage dependencies.
  4. Copy the UI directory.
  5. Overwrite the index.ts file.
  6. Execute pnpm install and pnpm build to manage the package and build the project.
  7. Merge the i18n file from the plugin with the original i18n file.
  8. Build a new binary.
  9. Clean up the byproducts generated during the build process.

answer-plugin-build-all.png

Reason

Here are the reasons behind our design choices:

Static Compilation

This is the main reason why the plugin system is designed this way.

React.js and Golang both these languages require compilation. They are not dynamically executable like some other scripting languages. So the plugin system should be static compilation, which means that the application and plugins are compiled together, resulting in a single binary that can be easily distributed and deployed.

Fixed Functionality

The plugin system allows users to add features that are fixed for their specific use cases without changing the core system. Furthermore, these functionalities persistently remain operational once they are employed. Therefore, it is sufficient to deliberate on the necessities of their incorporation at the initial stage, and subsequently, package them accordingly. In the future, we can build a Docker image that contains all officially plugins, thereby enabling users to access the entire range of features. The enablement or disablement of these functionalities can be managed through the plugin control interface.

Extension

The most important capability of a plugin system is actually its extensibility. It is impossible for a program to provide all the functions that every user wants. However, with a plugin system, users can develop their own plugins to help them achieve the functions that they want.

Reference

The Caddy is a great open-source software that inspired the design of the Answer plugin system. Caddy is a web server that allows developers to extend its functionality using plugins. Using xcaddy can easy to make custom builds of the Caddy Web Server.

More

In this blog post, we discussed the design and implementation of the plugin system for Answer, a popular open-source Q&A platform. We discussed the motivation behind the design, the features and principles of the plugin system, and provided a step-by-step guide on implementation. If you are interested in developing plugins for Answer, please feel free to leave us a comment. We will also write an article on how to implement an Answer plugin from scratch, so stay focus!

分享到