摘要本文旨在解决 ArcGIS JS API 在离线环境下字体库失效的问题。通过搭建 genfontgl 工具将本地字体转换为 .pbf 格式并部署从而保证地图渲染的 label 和 text 类型 symbol 在无网络时也能正常显示。为什么要有一套本地字体库ArcGIS JavaScript 默认使用的是他们域名里的字体库https://static.arcgis.com/fonts。如果在没有互联网的情况下有可能会导致访问字体库失败如下图。这样我们地图渲染的 label 或者 text 类型的 symbol 都会失效。所以我们需要有一套自己的字体库。ArcGIS 使用的字体格式不是 window 系统常用的 .ttf使用的是.pbf。查询了一番资料关于 .pbf 格式的字体很少有直接下载的网站。有一个转换的工具但是有系统限制只能使用 linux64 位或者 Mac OS X 环境。所以可能需要一台虚拟机搭建必要的环境。搭建genfontgl工具genfontgl 的后台是使用的 fontnik 这个库。注意 Fontnik 有对应的系统要求和 node 版本要求安装的 node 压缩包要注意匹配版本。首先默认存在 64 位 linux 系统的情况下直接可以按以下步骤安装 genfontgl 工具。1linux 安装 node 环境首先需要下载 linux 版本的 node 安装包使用 WinSCP 工具将安装包移入 root 目录也可以使用 wget 远程下载。wget https://npm.taobao.org/mirrors/node/v6.9.0/node-v6.9.0-linux-x64.tar.gz下载地址:CNPM Binaries Mirror这里可以新建一个文件夹存放压缩包根据个人习惯。WinSCP:Linux 控制台:解压到 /root 路径。-C 后面指定解压路径[rootlocalhost ysb]# tar -zxvf node-v6.9.0-linux-x64.tar.gz -C /root回到默认主目录 /root[rootlocalhost ysb]# cd ~重命名非必须[rootlocalhost ~]# mv node-v6.9.0-linux-x64/ node将npm以及node建立为全局命令[rootlocalhost ~]# ln -s /root/node/bin/node /usr/local/bin/node[rootlocalhost ~]# ln -s /root/node/bin/npm /usr/local/bin/npm查看[rootlocalhost ~]# cd /usr/local/bin[rootlocalhost bin]# ls将/root/node/bin配置到用户环境变量中[rootlocalhost bin]# cd ~[rootlocalhost ~]# vi .bash_profile更改下图红色区域路径为下图显示的路径立即执行修改使修改立即生效测试成功显示安装的版本号2安装升级GCC检查linux的当前gcc版本strings /usr/lib64/libstdc.so.6 | grep GLIBC如果没有下图红框的版本需要进行GCC升级安装所需工具[rootlocalhost ~]# clear[rootlocalhost ~]# yum groupinstall Development Tools[rootlocalhost ~]# yum install glibc-static libstdc-static下载gcc安装包下载地址:Index of /software/gcc/releases/远程下载wgethttp://ftp.tsukuba.wide.ad.jp/software/gcc/releases/gcc-5.4.0/gcc-5.4.0.tar.gz编译安装gcc-5.4.0:[rootlocalhost ysb]# tar -xvf gcc-5.4.0.tar.bz2[rootlocalhost ysb]# cd gcc-5.4.0[rootlocalhost gcc-5.4.0]# ./contrib/download_prerequisites[rootlocalhost gcc-5.4.0]# mkdir build[rootlocalhost gcc-5.4.0]# cd build[rootlocalhost build]#../configure --enable-checkingrelease --enable-languagesc,c --disable-multilib[rootlocalhost build]# make make install本人台式8G、3.2主频电脑配置编译完大概需要1个多小时安装完成后重启一下机器[rootlocalhost build]#reboot此时有libstdc.so.6.0.21[rootlocalhost ~]# find / -name libstdc.so*将上面的最新动态库libstdc.so.6.0.21复制到/usr/lib64目录下[rootlocalhost ~]# cp /usr/local/src/gcc-build-5.4.0/prev-x86_64-unknown-linux-gnu/libstdc-v3/src/.libs/libstdc.so.6.0.21 /usr/lib64删除之前的软连接并指向最新的动态库[rootlocalhost ~]# cd /usr/lib64[rootlocalhost lib64]# rm -rf libstdc.so.6libstdc.so.6 libstdc.so.6.0.19 libstdc.so.6.0.21[rootlocalhost lib64]# rm -rf libstdc.so.6[rootlocalhost lib64]# ln -s libstdc.so.6.0.21 libstdc.so.6查看[rootlocalhost lib64]# strings /lib64/libstdc.so.6 | grep GLIBC成功安装genfontgl转换字体以免费商用的阿里巴巴字体为例从网上下载阿里巴巴字体点击下面超链接也可下载http://aifont.oss-cn-beijing.aliyuncs.com/Alibaba%20PuHuiTi/Alibaba%20PuHuiTi_AlibabaSans.zip解压后找到字体文件使用WinSCP工具上传这里可以根据需要将字体上传。以Alibaba-PuHuiTi-Regular.otf为例。转换之前可以新建一个目录存放转换后的字体否则将默认转换至当前目录。[rootlocalhost ~]# mkdir ali-pbf-fonts转换[rootlocalhost ~]# cd ali-ttf-fonts/阿里巴巴普惠体/[rootlocalhost 阿里巴巴普惠体]# genfontgl Alibaba-PuHuiTi-Regular.otf /root/ali-pbf-fonts/查看修改命名格式修改为符合esri的命名格式。也可以直接通过winSCP工具修改或者先拉出来修改Esri的命令规范大致是:以下的weight和style是对于arcgis js api设置font属性而言的。不同的设置有不同的格式要求字体weightstyle格式(字母全部变为小写,空格用-单横线代替)Alibaba Pu Hui Ti-Regularnormalnormalalibaba-puhuiti-regularAlibaba Pu Hui Ti-Boldboldnormalalibaba-puhuiti-boldAlibaba Sans Italicnormalitalicalibaba-sans-italicAlibaba Sans Bold Italicbolditalicalibaba-sans-bold-italicArcgis JavaScript API加载本地字体1引入esri/config模块2设置fontsUrl这里路径是相对于你项目中当前文件的路径。我项目结构如下路径设置:3应用应用到text Symbol中测试图arial-unicode-ms阿里普惠体隶书