更新记录

1.0.3（2025-10-09）

• 修复新的sdk兼容问题，安卓依赖版本切换，以兼容4.76 sdk的版本打包匹配。

1.0.2（2024-09-18）

• 修复本地路径可能的错误.

1.0.1（2024-09-18）

• 修复本地路径可能的错误.

平台兼容性

uni-app(4.76)

uni-app x(4.76)

其他

x-pdf-u

开发文档

本插件会让你的安卓应用增加大约3.7mb体积 本插件会让你的IOS应用增加大约4kb体积

使用原生底层api打印和预览，没有第三方框架比如腾讯x5浏览器套壳或者webKit.纯 原生实现，为你的应用大小减负

功能说明

1. 内嵌式页面预览pdf文件,方便你定义预览pdf界面。
2. 支持打印预览，预览与打印结果一致。
3. 安卓或者手机会弹出打印预览界面，自行在手机上选择无线打印机或者隔空AirWifi打印机

兼容性

函数方法

请通过let ele = this.$refs["pdf"] as XPdfUElement来获取ele组件实例。

组件事件

使用示例

如果是安卓请务必打自定义基座

如果是ios：你在mac环境下配置好了环境无需打包本地编译，如果win开发ios需要打包基座。

// 在你的页面中引入pdf组件,组件遵守uni_modules规则，无需导入
<x-pdf-u ref='pdf' @pageChange="change" :url="url" style="width:100%;height:450px;"></x-pdf-u>

// 你的uts代码
<script>

    export default {
        data() {
            return {
                url:''
            }
        },
        onLoad() {
        },
        methods: {
            // 打印pdf
            sharePdf(){
                let ele = this.$refs["pdf"] as XPdfUElement
                ele.print()
            },
            // 用户在滑动pdf文件，页面变化时触发
            change(evt : UTSJSONObject){
                // {page: 7, pageCount: 32}
                console.log(evt)
            },
            // 跳转到指定页面
            pageTo(){
                let ele = this.$refs["pdf"] as XPdfUElement
                ele.jumpTo(2)
            },
            // 下载远程pdf文件给组件打印，也可以不本地下载，直接提供url远程链接，框架内部自行下载（不推荐）
            loadUrl(){
                let _this = this;
                uni.showLoading({title:"..."})
                uni.downloadFile({
                    url:"https://www.espressif.com/sites/default/files/documentation/0a-esp8266ex_datasheet_cn.pdf",
                    success(evt) {
                        uni.hideLoading()
                        let decodedPath = evt.tempFilePath
                        _this.url = decodedPath;
                    },
                    fail() {
                        uni.hideLoading()
                    }
                })

            }
        }
    }
<\/script>