鴻蒙開發實戰：基于【Markwon】移植和開發

本項目是基于開源項目Markwon進行適用harmonyos的移植和開發的。

移植版本：v4.6.2

1. 項目介紹

項目名稱：Markwon

所屬系列：harmonyos的第三方組件適配移植

功能：

• Emphasis (*, _)
• Strong emphasis (**, __)
• Strike-through (~~)
• Headers (#{1,6})
• Links () && [][])
• Images
• Thematic break (---, ***, ___)
• Quotes & nested quotes (>{1,})
• Ordered & non-ordered lists & nested ones
• Strike-through (, , )~~
• Link (a).

項目移植狀態：

項目已完成移植，完成度50%，差異如下

• 主界面點擊右上角圖標，進入README.md界面不能正常顯示內容
• 主界面stable 版本信息欄使用固定信息及樣式
• 主界面CHECK FOR UPDATE 點擊檢測更新版本無對應鏈接
• 主界面列表條目點擊后進入頁面不能正常顯示內容
• 主界面列表條目標簽4個以上不能自動換行
  添加了demo模塊用于效果展示；

編程語言：java

2. 集成指引

方式一

1. 下載或自行編譯生成Markwon的.har文件，文件路徑為：./demo/libs/Markwon-debug.har。
2. 自行編譯時，需要注意要自行添加簽名。
3. 導入你的harmonyos項目模塊的**./libs**中。
4. 在模塊下的build.gradle中確認依賴**./libs**下的.har包，implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])。
5. 在代碼中使用。

方式二：

1. 在根目錄的build.gradle文件中添加mavenCentral()：

   // Top-level build file where you can add configuration options common to all sub-projects/modules.
   ...
   buildscript {
       repositories {
           ...
           mavenCentral()
       }
       ...
   }
   
   allprojects {
       repositories {
           ...
           mavenCentral()
       }
   }
   

2. 在module目錄下的build.gradle文件中添加``

   ...
   dependencies {
       ...
       implementation 'com.gitee.ts_ohos:markwon:1.0.1'
   }
   

3. 使用說明

更多用法參考本項目的 demo ，原項目Java Doc與OHOS的文檔。
主要用法如下：

Inline HTML

< u >< i >H< sup >T< sub >M< /sub >< /sup >< b >< s >L< /s >< /b >< /i >< /u >

*HTML*

< ScrollView
  android:id="@+id/scroll_view"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:layout_marginTop="?android:attr/actionBarSize" >

  < TextView
    android:id="@+id/text"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_margin="16dip"
    android:lineSpacingExtra="2dip"
    android:textSize="16sp"
    tools:text="yonman" / >

< /ScrollView >

// username, repo, branch, lastPathSegment

    String RE_FILE = "^"+TextUtils.getHttps()+"github.com/([w-.]+?)/([w-.]+?)/(?:blob|raw)/([w-.]+?)/(.+)$";
    private static final String RE_REPOSITORY = "^"+TextUtils.getHttps()+"github.com/([w-.]+?)/([w-.]+?)/*$";

    public static Pair< String, String > parseRepository(String url) {

        Pattern pattern = Pattern.compile(RE_REPOSITORY);
        Matcher matcher = pattern.matcher(url);
        if (matcher.matches()) {
            String user = matcher.group(1);
            String repository = matcher.group(2);
            if (TextUtils.isEmpty(user) || TextUtils.isEmpty(user)) {
                return new Pair<  >(null, null);
            } else {
                return new Pair<  >(user, repository);
            }
        } else {
            return new Pair< String, String >(null, null);
        }
    }

private static final String SAMPLE_PREFIX = "io.noties.markwon.app.";

    @NonNull
    public static List< Sample > readSamples(@NonNull Context context) {

        RawFileEntry rawFileEntry = context.getResourceManager().getRawFileEntry("resources/rawfile/samples.json");
        try (InputStream inputStream = rawFileEntry.openRawFile()) {
            return readSamples(inputStream);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

更多鴻蒙開發應用知識已更新gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md參考前往。

或+mau123789學習，是v喔

4. 效果演示

1. 主界面展示
2. 點擊item中plugin標簽，顯示選擇結果

*注 : demo中的圖片是點擊不同標簽，進行篩選顯示結果

5. 版本迭代

• v1.0.0 基于原項目最新版本，移植功能及提交。
• v1.0.1 更新harmonyos API至5。

6. 版本和許可信息

• Apache License 2.0
• [LICENSE]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

審核編輯 黃宇