打包FlaskAdmin程序时关于static路径问题的解决

将FlaskAdmin程序打包成一个单独的可执行文件，可以极大地方便运行和分发。但是在打包的过程中常常会遇到static路径的问题。下面是关于解决static路径问题的攻略。

问题描述

在FlaskAdmin程序中，我们通常需要在后台管理页面中使用静态资源。在开发过程中，我们可以使用相对路径（如"./static/js/myscript.js"）来指定静态资源的路径。但是在打包中，之前的静态资源路径就会无法访问，造成页面无法正常显示。

解决方案

解决这个问题最直接的方式就是把静态资源复制到程序打包后的静态路径中。我们可以使用以下两种方式解决该问题：

方案一：使用Flask-Assets

Flask-Assets 可以自动管理Flask程序中的静态文件，将它们压缩并合并成一个文件，并将其加入到您的模板中。

在程序中的__init__.py文件中引入Flask-Assets：

from flask_assets import Environment

assets = Environment()

def create_app():
    app = Flask(__name__)
    assets.init_app(app)
    ...

然后，我们创建一个资产捆绑器以管理静态文件。

from webassets import Bundle

js = Bundle('js/my_script.js', output='gen/packed.js')
assets.register('js_all', js)

css = Bundle('css/my_style.css', output='gen/packed.css')
assets.register('css_all', css)

注意：output参数应该是相对于static文件夹的路径。

最后，在模板文件中使用以下代码来实现你需要的样式和JS加载

{% assets "js_all" %}
    <script type="text/javascript" src="{{ ASSET_URL }}"></script>
{% endassets %}

{% assets "css_all" %}
    <link type="text/css" rel="stylesheet" href="{{ ASSET_URL }}" />
{% endassets %}

在打包成单独可执行文件时，静态资源会被打包到文件中。

方案二：手动复制静态文件

我们可以将静态文件复制到程序输出目录下的static目录。我们可以在打包前实现自动化复制，以保证静态文件被正确地打包。

示例1：

from shutil import copytree
from distutils.dir_util import copy_tree

# 复制目录
copytree('static/', 'dist/static')

# 复制文件夹中的所有文件
copy_tree('static/js/', 'dist/static/js/')
copy_tree('static/css/', 'dist/static/css/')

示例2：

import os
import shutil

# 获取程序运行目录
app_root = os.path.dirname(os.path.abspath(__file__))

# 静态文件路径
static_files_dir = os.path.join(app_root, 'static')

# 程序发布目录
dist_dir = os.path.join(app_root, 'dist')

# 复制静态文件到发布目录中
shutil.copytree(static_files_dir, os.path.join(dist_dir, 'static'))

总结

以上是解决FlaskAdmin程序打包后静态文件路径的两种方法。您可以根据自己喜好选择其中一种方案解决问题。