From 06806d98bf1ef00271c410ad2b563bb767066303 Mon Sep 17 00:00:00 2001 From: etkmao Date: Fri, 14 Jun 2024 14:04:42 +0800 Subject: [PATCH 1/5] fix(core): fix android scope crash (#3906) --- driver/js/src/scope.cc | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/driver/js/src/scope.cc b/driver/js/src/scope.cc index 75e8137063e..5b5ef8a825f 100644 --- a/driver/js/src/scope.cc +++ b/driver/js/src/scope.cc @@ -136,11 +136,13 @@ Scope::~Scope() { */ #else auto engine = engine_.lock(); - FOOTSTONE_CHECK(engine); - auto key = wrapper_.get(); - engine->ClearWeakCallbackWrapper(key); - engine->ClearFunctionWrapper(key); - engine->ClearClassTemplate(key); + FOOTSTONE_DCHECK(engine); + if (engine) { + auto key = wrapper_.get(); + engine->ClearWeakCallbackWrapper(key); + engine->ClearFunctionWrapper(key); + engine->ClearClassTemplate(key); + } #endif } From 403af1a149dd632b8d97c463267438cf9e866391 Mon Sep 17 00:00:00 2001 From: xiezheng-XD <141627292+xiezheng-XD@users.noreply.github.com> Date: Fri, 14 Jun 2024 14:53:00 +0800 Subject: [PATCH 2/5] docs(vue): typo in vue's README.md (#3444) --- driver/js/packages/hippy-vue-native-components/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/driver/js/packages/hippy-vue-native-components/README.md b/driver/js/packages/hippy-vue-native-components/README.md index 623db39852a..9ed28279d0b 100644 --- a/driver/js/packages/hippy-vue-native-components/README.md +++ b/driver/js/packages/hippy-vue-native-components/README.md @@ -1,6 +1,6 @@ # Hippy Vue Native Components -> The package contains the **Native only** components provide by Hippy. +> The package contains the **Native only** components provided by Hippy. > For web alternative could use `hippy-vue-web-components`(it's not exist yet). ![Hippy Group](https://img.shields.io/badge/group-Hippy-blue.svg) From b6697c53d99a7e91304371ee13203e1ff2969e2b Mon Sep 17 00:00:00 2001 From: wwwcg Date: Wed, 12 Jun 2024 20:03:33 +0800 Subject: [PATCH 3/5] fix(ios): add CSS name matching semantics to fontFamily of TextInput --- .../textinput/HippyTextViewManager.mm | 31 +++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-) diff --git a/renderer/native/ios/renderer/component/textinput/HippyTextViewManager.mm b/renderer/native/ios/renderer/component/textinput/HippyTextViewManager.mm index 98299687dcc..56f21a09f1f 100644 --- a/renderer/native/ios/renderer/component/textinput/HippyTextViewManager.mm +++ b/renderer/native/ios/renderer/component/textinput/HippyTextViewManager.mm @@ -185,23 +185,30 @@ - (HippyShadowView *)shadowView { } HIPPY_CUSTOM_SHADOW_PROPERTY(fontFamily, NSString, HippyShadowTextView) { - view.font = [HippyFont updateFont:view.font withFamily:json]; + // Convert fontName to fontFamily if needed + NSString *familyName = [self familyNameWithCSSNameMatching:json]; + view.font = [HippyFont updateFont:view.font withFamily:familyName]; } HIPPY_CUSTOM_VIEW_PROPERTY(fontSize, NSNumber, HippyBaseTextInput) { UIFont *theFont = [HippyFont updateFont:view.font withSize:json ?: @(defaultView.font.pointSize)]; view.font = theFont; } + HIPPY_CUSTOM_VIEW_PROPERTY(fontWeight, NSString, __unused HippyBaseTextInput) { UIFont *theFont = [HippyFont updateFont:view.font withWeight:json]; // defaults to normal view.font = theFont; } + HIPPY_CUSTOM_VIEW_PROPERTY(fontStyle, NSString, __unused HippyBaseTextInput) { UIFont *theFont = [HippyFont updateFont:view.font withStyle:json]; view.font = theFont; // defaults to normal } + HIPPY_CUSTOM_VIEW_PROPERTY(fontFamily, NSString, HippyBaseTextInput) { - view.font = [HippyFont updateFont:view.font withFamily:json ?: defaultView.font.familyName]; + // Convert fontName to fontFamily if needed + NSString *familyName = [self familyNameWithCSSNameMatching:json]; + view.font = [HippyFont updateFont:view.font withFamily:familyName ?: defaultView.font.familyName]; } - (HippyViewManagerUIBlock)uiBlockToAmendWithShadowView:(HippyShadowView *)hippyShadowView { @@ -211,4 +218,24 @@ - (HippyViewManagerUIBlock)uiBlockToAmendWithShadowView:(HippyShadowView *)hippy viewRegistry[componentTag].contentInset = padding; }; } + + +#pragma mark - Private + +/// Get the +/// JS side usually pass a `fontName` instead of `fontFamily` +/// - Parameter json: id +- (NSString *)familyNameWithCSSNameMatching:(id)json { + NSString *familyName = json; + if (json && ![[UIFont familyNames] containsObject:json]) { + // Not a real FamilyName + // Using CSS name matching semantics. + // fontSize here is just a placeholder for getting font. + UIFont *cssFont = [UIFont fontWithName:json size:14.0]; + familyName = cssFont.familyName; + } + return familyName; +} + + @end From 30d12f99ce85b89b50a8524d4ac834dce8a1781c Mon Sep 17 00:00:00 2001 From: siguangli Date: Fri, 14 Jun 2024 19:37:16 +0800 Subject: [PATCH 4/5] refactor(docs): update 3.0 upgrade guidelines md (#3908) Co-authored-by: siguangli --- .../android-3.0-upgrade-guidelines.md | 164 +++++++----------- .../feature3.0/image-decoder-adapter.md | 35 ++++ 2 files changed, 93 insertions(+), 106 deletions(-) create mode 100644 docs/feature/feature3.0/image-decoder-adapter.md diff --git a/docs/development/android-3.0-upgrade-guidelines.md b/docs/development/android-3.0-upgrade-guidelines.md index 626f6055653..facbc2a9077 100644 --- a/docs/development/android-3.0-upgrade-guidelines.md +++ b/docs/development/android-3.0-upgrade-guidelines.md @@ -5,42 +5,21 @@ --- -# Maven依赖项变更 +# 升级依赖项变更 3.0 SDK集成依赖项相对2.0有所变更，开发者可以参照[Hippy Android 3.x SDK集成指引](development/android-3.0-integration-guidelines.md)更新自己工程中的依赖项。

-# 升级基础适配项（required） +# 接入与使用方式变更 -1. 废弃引擎初始化参数HippyImageLoader +**3.0针对终端引擎接入，部分类及接口调用方式上做了以下调整：** - HippyImageLoader在2.0中作为引擎初始化必设项是不合理的，在3.0中已经废弃，开发者需要在引擎初始化中移除HippyImageLoader相关的设置参数与实现。
- 3.0图片资源拉取会和其它所有IO相关的资源一样统一走VFS模块进行分发，远程网络资源请求最终会由VFS模块会分发到HttpAdapter进行处理，如果开发者需要将图片请求和其他资源请求进行区分处理，可以参照下面代码示例在自定义的HttpAdapter中Override fetch接口，通过请求参数来判断是否为图片资源的请求： - - ```java - @Override - public void fetch(@NonNull final ResourceDataHolder holder, - @Nullable HashMap nativeParams, - @NonNull final VfsManager.ProcessorCallback callback) { - HashMap rp = holder.requestParams; - if (rp != null && rp.containsKey(REQUEST_CONTENT_TYPE) - && rp.get(REQUEST_CONTENT_TYPE).equals(REQUEST_CONTENT_TYPE_IMAGE)) { - // 这里处理图片资源请求 - } else { - // 这里处理其它资源的请求 - } - } - ``` - -2. 引擎初始化完成callback回调线程调整 - - 2.0中initEngine初始化结果SDK内部会切换到UI线程再callback onInitialized给宿主，但我们发现在一些业务使用场景下，callback切UI线程执行可能具有很大的延迟，所以3.0中callback onInitialized直接在子线程回调并继续执行loadModule会有更好的效率。
- 在原2.0引擎初始化callback中如果有对hippyRootView挂载等相关的UI操作，需要开发者自己增加UI线程的切换逻辑来保证。 +1. 引擎初始化完成callback回调线程调整
+ 为了提升引擎初始化效率，3.0中引擎初始化完成callback onInitialized直接在子线程回调并继续执行loadModule。2.0在onInitialized中如果有对hippyRootView挂载等相关的UI操作，需要开发者自己增加UI线程的切换逻辑来保证。 -3. 引擎销毁调用方式与顺序调整 - - 3.0中destroyModule增加了回调接口，destroyEngine需要等destroyModule执行完成回调以后才能调用，否则可能有CRASH的风险，开发者需要将2.0原有的引擎销毁逻辑按下面的代码示例进行变更： +2. 引擎销毁调用方式与顺序调整
+ 3.0中destroyModule增加了回调接口，destroyEngine需要等destroyModule执行完成回调以后才能调用，否则可能有CRASH的风险，新的释放流程流程参照以下代码示例： ```java fun destroyEngine(hippyEngine: HippyEngine?, hippyRootView: ViewGroup?) { @@ -49,17 +28,15 @@ } ``` -4. HippyEngine中的接口不再直接引用HippyRootView - - destroyModule接口参数以及loadModule接口返回值均使用系统ViewGroup类型替代，尽量减少对SDK的耦合，开发者需要对loadModule接口返回值类型做相应的调整。 +3. 废弃引擎初始化参数HippyImageLoader
+ HippyImageLoader在2.0中作为引擎初始化必设项是不合理的，在3.0中已经废弃，开发者需要在引擎初始化中移除HippyImageLoader相关的设置参数与实现。
+ 3.0图片资源拉取会和其它所有IO相关的资源一样统一走VFS模块进行分发，远程网络资源请求最终会由VFS模块会分发到HttpAdapter进行处理。 -5. ModuleListener接口定义变更 - 开发者需要对loadModule接口参数ModuleListener做以下2点适配 - - 我们发现之前2.0在onLoadCompleted回调接口中返回的root view参数其实在各多业务场景都不会去用到，所以在3.0中我们简化了这个接口，移除了root view参数的返回 - - 增加onFirstViewAdded接口回调，返回第一view挂载到Hippy root view的回调时机 +4. 废弃HippyInstanceContext定义及其相关实现
+ 随着3.0 framework和renderer两个子模块的解耦，我们发现HippyInstanceContext设计过于臃肿，已经不再适用于最新的3.0架构，所以我们在最新的3.0版本中废弃了HippyInstanceContext，改用更加轻量化的NativeRenderContext取代。 -6. UI Component事件发送 - Hippy终端事件的发送分为全局事件和UI Component事件2种，全局事件和2.0保持一致，使用HippyEngine中暴露的sendEvent接口发送，而UI Component事件的发送，开发者需要统一使用使用3.0新增工具类EventUtils中封装的事件发送接口: +5. UI Component事件发送
+ 3.0 UI Component事件的发送，开发者需要统一使用使用3.0新增工具类EventUtils中封装的事件发送接口: ```java @MainThread @@ -68,40 +45,52 @@ @Nullable Object params); ``` -7. 废弃HippyInstanceContext定义及其相关实现 - 2.0中基于系统ContextWrapper封了Hippy自己的HippyInstanceContext，并将其作为所有Hippy view的初始化参数，随着3.0 framework和renderer两个子模块的解耦，我们发现HippyInstanceContext设计过于臃肿，已经不再适用于最新的3.0架构，所以我们在最新的3.0版本中废弃了HippyInstanceContext，改用更加轻量化的NativeRenderContext取代，所以开发者需要将自定义组件中使用到HippyInstanceContext的相关实现变更为NativeRenderContext。 +
+ +# 组件变更 + +**3.0针对部分组件做了相应的重构，如果开发者基于老组件扩展了自定义组件，需要做以下适配：** -8. 废弃support ui下面RecyclerView及其派生类HippyListView相关实现，随着瀑布流组件重构完成，HippyWaterfallView已经与HippyRecyclerView共同派生于系统androidX的RecyclerView，老版本的support ui组件已经可以彻底废弃，因此以下2个目录下所有实现文件已经从sdk中移除 - - com/tencent/mtt/supportui/views/recyclerview/ - - com/tencent/mtt/hippy/views/list/
+1. 废弃support ui下面RecyclerView及其派生类HippyListView组件
+ 3.0的HippyWaterfallView重构后已经不再依赖support ui相关组件，以下2个目录下所有实现文件已经从sdk中移除
+ com/tencent/mtt/supportui/views/recyclerview/
+ com/tencent/mtt/hippy/views/list/
之前开发者如果基于HippyListView派生了自己定义的list view组件，需要修改并适配为继承于HippyRecyclerView - -9. HippyRootView下面getLaunchParams方法已被废弃，可以使用HippyEngineContext下面getJsParams接口来替代。 -10. 简化HippyHttpRequest类实现，移除了以下接口定义: +
+ +# 接口定义变更 + +**3.0对部分接口定义及参数了做了调整，如果开发者有使用到以下接口需要做相应适配：** + +1. ModuleListener接口定义变更
+ - onLoadCompleted回调接口移除了root view参数的返回 + - 增加onFirstViewAdded接口回调，返回第一view挂载到Hippy root view的回调时机 + +2. HippyEngineContext类中部分接口调整
+ - 新增findViewById(int nodeId)，可以通过node id查找对应的view + - 移除getDomManager()与getRenderManager()两个接口 + - getEngineId()接口转移至HippyEngine类下 + - 废弃getInstance(int id)接口，由新增getRootView()接口替代 + +3. 废弃HippyRootView中getLaunchParams接口
+ 使用HippyEngineContext下面getJsParams接口来替代。 + +4. HippyEngine类中接口参数调整
+ 为尽量减少接入方对SDK的耦合，destroyModule接口参数以及loadModule接口返回值由原来HippyRootView类型改为系统ViewGroup类型替代。 + +5. HippyHttpRequest类中接口定义变更
+ 由于mInitParams参数在HippyHttpRequest创建的时候就作为初始化参数传入，后续一些依赖mInitParams获取参数的逻辑封装在HippyHttpRequest内部更合理，所以我们移除了以下set接口，只保留get接口： - public void setMethod(String method) - public void setInstanceFollowRedirects(boolean instanceFollowRedirects) - public void setBody(String body) - public void setNativeParams(Map nativeParams) - public void setInitParams(HippyMap initParams) - public void setInstanceFollowRedirects(boolean instanceFollowRedirects) -
- 由于mInitParams参数在HippyHttpRequest创建的时候就作为初始化参数传入，后续一些依赖mInitParams获取参数的逻辑封装在HippyHttpRequest内部更合理，所以我们移除了相关的set接口，只保留get接口. -
- 该项调整对于之前2.x中开发者定义了继承于DefaultHttpAdapter的自定义HippyHttpAdapter，并且使用到HippyHttpRequest相关接口的需要做一定适配，适配过程中也可以参考我们github工程main分支DefaultHttpAdapter与HippyHttpRequest具体实现。 - -11. HippyEngineContext下部分接口调整: - - 新增findViewById(int nodeId)，可以通过node id查找对应的view - - 移除getDomManager()与getRenderManager()两个接口，之前通过RenderManager查找view的方法通过上述新增接口替代 - - getEngineId()接口转移至HippyEngine类下 - - 废弃getInstance(int id)接口，由新增getRootView()和getRootView(int rootId)两个接口替代，目前多root view支持还未完善，所以两个getRootView接口调用效果一致 -
- 如果开发者在之前的2.x版本上使用到以上接口，可以根据自己的需要做相应适配调整 - -12. HippyViewController下面移除getInnerPath(HippyInstanceContext context, String path)接口实现，之前开发者自定义组件Controller中有Override该接口需要重新适配，3.0 image uri local path的转换在ImageComponent中通过convertToLocalPathIfNeeded(String uri)接口实现，目前暂时还不支持开发者自定义。 -13. HippyViewController中onManageChildComplete接口已经被废弃，统一使用onBatchComplete接口替代，之前2.x列表滚动过程中，view复用后默认都会调用onManageChildComplete，但3.x中为了减少一些无效的调用逻辑进一步提升列表滚动流畅性，列表滚动view复用的时候默认不会调用onBatchComplete，如果想接收onBatchComplete调用做一些定制逻辑需要做以下适配： - - 定义自定义组件对应的RenderNode(类名自定义)，并Override shouldNotifyNonBatchingChange接口 +6. 废弃HippyViewController中onManageChildComplete接口
+ 统一使用onBatchComplete接口替代，之前2.x列表滚动过程中，view复用后默认都会调用onManageChildComplete，但3.x中为了减少一些无效的调用逻辑进一步提升列表滚动流畅性，列表滚动view复用的时候默认不会调用onBatchComplete，如果想接续接收onBatchComplete调用需要做以下适配：
+ （1） 定义自定义组件对应的RenderNode(类名自定义)，并Override shouldNotifyNonBatchingChange接口 ```java public class CustomRenderNode extends RenderNode { @@ -121,7 +110,7 @@ } ``` - - 在自定义组件Controller中Override createRenderNode接口并增加自定义RenderNode的创建逻辑 + （2） 在自定义组件Controller中Override createRenderNode接口并增加自定义RenderNode的创建逻辑 ```java @Override @@ -134,54 +123,17 @@ } ``` -# 新增特性适配项（optional） - -1. 引擎初始化参数增加资源请求自定义processor的设置 - - ```java - public List processors; - ``` - - 关于VFS特性以及Processor接口使用的介绍可以详见 [VFS](feature/feature3.0/vfs.md)。 - -2. 引擎初始化参数增加ImageDecoderAdapter的设置 - 如果开发者有自定义格式图片的解码需求，可以在引擎初始化参数中设置ImageDecoderAdapter，ImageDecoderAdapter的具体接口描述如下： - - ```java - // 解码image原始数据，解码的结果可以通过 image data holder提供的setBitmap或者setDrawable接口 - // 置到holder中，如果宿主decode adapter不处理，返回false由SDK走默认解码逻辑 - boolean preDecode(@NonNull byte[] data, - @Nullable Map initProps, - @NonNull ImageDataHolder imageHolder, - @NonNull BitmapFactory.Options options); +
- // 解码结束后，宿主通过该接口回调还可以获得二次处理bitmap的机会，比如要对bitmap做高斯模糊。 - void afterDecode(@Nullable Map initProps, - @NonNull ImageDataHolder imageHolder, - @NonNull BitmapFactory.Options options); +# 新增特性 - // 引擎退出销毁时调用，释放adapter可能占用的资源 - void destroyIfNeeded(); - ``` +**3.0中新增以下新特性的支持，开发者可以根据自己的需求进行选择性适配：** -3. HippyEngine中新增render node缓存特性接口 - 2.0中我们支持了dom node缓存特性，但dom node缓存针对复杂页面场景性能还是存在一定的性能瓶颈，所有我们在3.0重新实现了性能更好的render node缓存特性，关于render node缓存特性与接口使用的介绍可以详见 [RenderNode Snapshot](feature/feature3.0/render-node-snapshot.md)。 +1. 新增统一资源请求处理模块-VFS，具体使用方式可以详见 [VFS](feature/feature3.0/vfs.md) 特性文档介绍。 -4. 关于自定义UI组件的Controller中dispatchFunction参数说明 - 在2.0中dispatchFunction接收事件属性的参数类型为HippyArray类型，由于在2.0的后续版本中HippyMap和HippyArray就已经被标记为@Deprecated，所以在3.0的重构中，SDK内部也逐渐替换一些使用HippyMap或HippyArray类型参数的接口，所以针对Controller的dispatchFunction接口SDK内部默认替换成List类型参数 +2. 新增ImageDecoderAdapter支持接入自定义图片解码器，具体使用方式可以详见 [ImageDecoderAdapter](feature/feature3.0/image-decoder-adapter.md) 特性文档介绍。 - ```java - public void dispatchFunction(@NonNull T view, - @NonNull String functionName, - @NonNull List params); - - public void dispatchFunction(@NonNull T view, - @NonNull String functionName, - @NonNull List params, - @NonNull Promise promise)； - ``` +3. 新增Render Node缓存特性优化启动速度，具体使用方式可以详见 [RenderNode Snapshot](feature/feature3.0/render-node-snapshot.md) 特性文档介绍。 - 为了减低3.0升级的成本原来使用HippyArray类型的接口还是保留，只是标记为@Deprecated，所以升级3.0对于原来定义的dispatchFunction接口不需要做任何修改，但建议后续升级到3.0版本定义新UI组件的时候，直接Override使用List参数类型的新接口。 +4. 新增Screenshot截屏特性，具体使用方式可以详见 [Screenshot for specific views](feature/feature3.0/screenshot.md) 特性文档介绍。 -5. HippyEngine中新增Screenshot截屏特性接口 - 过去在一些业务的使用场景中需要针对指定的Hippy view进行截图并做分享，之前截图逻辑都是由开发者自己实现，为了进一步降低开发者的适配成本，我们把截图能力下沉到了SDK，为开发者提供更为便捷的使用方式，关于Screenshot截屏特性与接口使用的介绍可以详见 [Screenshot for specific views](feature/feature3.0/screenshot.md)。 diff --git a/docs/feature/feature3.0/image-decoder-adapter.md b/docs/feature/feature3.0/image-decoder-adapter.md new file mode 100644 index 00000000000..988c67dd144 --- /dev/null +++ b/docs/feature/feature3.0/image-decoder-adapter.md @@ -0,0 +1,35 @@ +# ImageDecoderAdapter + +--- + +## 背景 + +3.0我们在HippyEngine引擎初始化参数中增加了ImageDecoderAdapter的设置，如果有开发者业务中有使用到特殊格式的图片，如SharpP、avif等，可以通过设置ImageDecoderAdapter来对接你的自定义图片解码器，具体接口描述如下： + +## 3.0 图片解码Adapter接口定义 + +### ImageDecoderAdapter Public methods + + ```java + boolean preDecode(@NonNull byte[] data, + @Nullable Map initProps, + @NonNull ImageDataHolder imageHolder, + @NonNull BitmapFactory.Options options); + ``` + + 该接口在拉取到图片原始数据的时候会调用，解码的结果可以通过image data holder提供的setBitmap或者setDrawable接口设置到holder中，并且返回true，表示不需要sdk再做解码操作，如果返回false表示需要sdk做默认的解码操作。 + + ```java + void afterDecode(@Nullable Map initProps, + @NonNull ImageDataHolder imageHolder, + @NonNull BitmapFactory.Options options); + ``` + + + 该接口在解码结束后会调用，为开发者提供二次处理bitmap的机会， 比如要对bitmap做高斯模糊。 + + ```java + void destroyIfNeeded(); + ``` + + 引擎退出销毁时调用，释放adapter可能占用的资源 From c6b8b0f4e6cdb5aa38737f49f916c58ad60f13f8 Mon Sep 17 00:00:00 2001 From: zealotchen Date: Fri, 14 Jun 2024 21:59:06 +0800 Subject: [PATCH 5/5] feat(doc): update js doc --- docs/development/_sidebar.md | 4 +- ...> react-vue-3.0-integration-guidelines.md} | 2 +- .../react-vue-3.0-upgrade-guidelines.md | 39 +++++++++++++++---- 3 files changed, 35 insertions(+), 10 deletions(-) rename docs/development/{react-vue-integration-guidelines.md => react-vue-3.0-integration-guidelines.md} (99%) diff --git a/docs/development/_sidebar.md b/docs/development/_sidebar.md index fe7159d8d76..efbff78397d 100644 --- a/docs/development/_sidebar.md +++ b/docs/development/_sidebar.md @@ -1,8 +1,8 @@ - [Demo体验](development/demo.md) - 前端接入 - - [Hippy React&Vue接入指引](development/react-vue-integration-guidelines.md) - - [Hippy React&Vue 3.x升级指引](development/react-vue-3.0-upgrade-guidelines.md) + - [Hippy-React&Vue 3.x SDK集成指引](development/react-vue-3.0-integration-guidelines.md) + - [Hippy-React&Vue 3.x SDK升级指引](development/react-vue-3.0-upgrade-guidelines.md) - [Web同构接入指引](development/web-integration-guidelines.md) - 终端接入 - [Android 3.x SDK集成指引](development/android-3.0-integration-guidelines.md) diff --git a/docs/development/react-vue-integration-guidelines.md b/docs/development/react-vue-3.0-integration-guidelines.md similarity index 99% rename from docs/development/react-vue-integration-guidelines.md rename to docs/development/react-vue-3.0-integration-guidelines.md index d458a1268fa..5ad00db5761 100644 --- a/docs/development/react-vue-integration-guidelines.md +++ b/docs/development/react-vue-3.0-integration-guidelines.md @@ -133,7 +133,7 @@ export default function app() { # hippy-vue ->注意：因vue2.x版本将于年底停止更新，建议用户升级至使用vue3.x版本的@hippy/vue-next +>注意：因vue2.x版本将停止更新，建议用户升级至使用vue3.x版本的@hippy/vue-next [[hippy-vue 介绍]](api/hippy-vue/introduction.md) [[范例工程]](//github.com/Tencent/Hippy/tree/master/examples/hippy-vue-demo) diff --git a/docs/development/react-vue-3.0-upgrade-guidelines.md b/docs/development/react-vue-3.0-upgrade-guidelines.md index 2f0f84d51e4..94c2707d153 100644 --- a/docs/development/react-vue-3.0-upgrade-guidelines.md +++ b/docs/development/react-vue-3.0-upgrade-guidelines.md @@ -1,10 +1,10 @@ # Hippy React&Vue 3.x SDK升级指引 -> 这篇教程，主要介绍Hippy React&Vue 如何升级3.0版本以及升级后的相关验证关注点。 +> 这篇教程，主要介绍 Hippy React&Vue&Vue-next 如何升级3.0版本以及升级后的相关验证关注点。 --- -# 依赖升级 +# 升级依赖项变更 ## hippy-react @@ -29,7 +29,7 @@ （3）如果使用了 @hippy/react-web 包做h5同构，则需要升级 @hippy/react-web 到 3.2.0-beta 及以上 ``` -Hippy-React 在升级3.0可以完全兼容之前的版本，除了升级如上依赖，业务代码不需要做修改。 +需要业务使用新的 hippy-react 重编 js common包 ## hippy-vue @@ -47,9 +47,7 @@ Hippy-React 在升级3.0可以完全兼容之前的版本，除了升级如上 （6）vue 和 vue-router 等vue相关依赖无需升级 ``` -Hippy-Vue 在升级3.0可以完全兼容之前的版本，除了升级如上依赖，业务代码不需要做修改。 - - +需要业务使用新的 hippy-vue 重编 js common包 ## hippy-vue-next @@ -65,11 +63,38 @@ Hippy-Vue 在升级3.0可以完全兼容之前的版本，除了升级如上依 （4）vue 和 vue-router 等vue相关依赖无需升级 ``` -Hippy-Vue-Next 在升级3.0可以完全兼容之前的版本，除了升级如上依赖，业务代码不需要做修改。 +需要业务使用新的 hippy-vue-next 重编 js common包

+# 接入与使用方式变更 + +接入 Hippy-React、Hippy-Vue、Hippy-Vue-Next SDK 代码无变化，可参考 [前端集成指引](development/react-vue-3.0-integration-guidelines.md) + +具体变化点如下： + +1. iOS 新增节点层级优化算法，Android 优化了现有的层级优化算法： +该算法会将仅参与布局的View节点优化去除，从而提升渲染效率。请注意 ！！！由于该算法的存在，可能导致依赖特定UI层级结构的native组件发生找不到特定View的异常。 +此时，可以通过前端代码中给特定 View 增加 collapsable: 'false' 属性来禁止该节点被优化算法去除。 + + +# 组件变更 + +1. dialog 组件的第一个子元素不能设置 { position: absolute } 样式，如果想将 dialog 内容铺满全屏，可以给第一个子元素设置 { flex: 1 } 样式或者显式设置 width 和 height 数值 + +2. Image 组件废弃了 source、 sources、srcs 字段，建议使用 src 字段代表图片 url + +3. iOS Image 组件默认没有实现图片缓存 （由于实现机制的变化），需要业务 iOS端自行实现缓存管理，详细可参考 [iOS 升级指引](development/ios-3.0-upgrade-guidelines.md) + +# 接口定义变更 + +1. hippy-react 不再导出RNfqb、RNfqbRegister、RNfqbEventEmitter、RNfqbEventListener 方法 + +2. hippy-react animation 模块不再有 destory() 方法的错误写法兼容，统一用 destroy() + +3. hippy-react animation 事件监听不再支持 onRNfqbAnimationXX 兼容写法，统一用 onHippyAnimationXX 或者 onAnimationXX + # 验证关注点 一、Hippy 3.0 前端架构升级主要有如下改动点：