KotlinでAndroidアプリのHTMLを解析する方法！Jsoupライブラリの使い方を徹底解説

このチュートリアルでは、Kotlinを使用してAndroidアプリ内でHTMLを解析（パース）する方法を解説します。HTML解析には、Java/Kotlin向けに広く使われているオープンソースライブラリ「Jsoup」を活用します。Jsoupを使えば、Webページからタイトルやリンクなどの要素を簡単に抽出できます。

ステップ1：新規プロジェクトの作成

まずはAndroid Studioで新しいプロジェクトを作成しましょう。メニューから「File」⇒「New Project」を選択し、必要な項目をすべて入力してプロジェクトを作成します。

ステップ2：レイアウトファイルの編集

res/layout/activity_main.xml に以下のコードを追加します。ここでは、HTML取得用のButtonと、解析結果を表示するTextViewを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
   xmlns:tools="https://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:padding="8dp"
   tools:context=".MainActivity">
   <Button
      android:id="@+id/btnParseHTML"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_marginTop="30dp"
      android:text="Get website" />
   <TextView
      android:textColor="@android:color/background_dark"
      android:id="@+id/textView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_below="@id/btnParseHTML"
      android:layout_centerHorizontal="true"
      android:text="Result"
      android:textSize="12sp"
      android:textStyle="bold" />
</RelativeLayout>

ステップ3：Jsoupライブラリの依存関係を追加

build.gradle（Module: app）に以下の依存関係を追加してください。これによりJsoupがプロジェクトで利用可能になります。

implementation 'org.jsoup:jsoup:1.11.2'

ステップ4：MainActivity.ktの実装

src/MainActivity.kt に以下のコードを記述します。ネットワーク処理はメインスレッドでは行えないため、バックグラウンドスレッド上でJsoupによりWebサイトへ接続し、ページのタイトルとすべてのリンク（href属性およびテキスト）を取得。その後、runOnUiThreadでUIスレッドに戻り、結果をTextViewに表示しています。

import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
import org.jsoup.Jsoup
import org.jsoup.nodes.Document
import org.jsoup.select.Elements
import java.io.IOException
class MainActivity : AppCompatActivity() {
   lateinit var button: Button
   lateinit var textView: TextView
   override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setContentView(R.layout.activity_main)
      title = "KotlinApp"
      textView = findViewById(R.id.textView)
      button = findViewById(R.id.btnParseHTML)
      button.setOnClickListener {
         getHtmlFromWeb()
      }
   }
   private fun getHtmlFromWeb() {
      Thread(Runnable {
         val stringBuilder = StringBuilder()
         try {
            val doc: Document = Jsoup.connect("https://www.tutorialspoint.com/").get()
            val title: String = doc.title()
            val links: Elements = doc.select("a[href]")
            stringBuilder.append(title).append("\n")
            for (link in links) {
               stringBuilder.append("\n").append("Link :
               ").append(link.attr("href")).append("\n").append("Text : ").append(link.text())
            }
         } catch (e: IOException) {
            stringBuilder.append("Error : ").append(e.message).append("\n")
         }
         runOnUiThread { textView.text = stringBuilder.toString() }
      }).start()
   }
}

ポイント：平文通信についての注意

接続先URLが「https://」ではなく「https://」の場合、Android 9（APIレベル28）以降では既定で平文通信がブロックされます。その際はAndroidManifest.xmlのapplicationタグに android:usesCleartextTraffic="true" を追加するか、HTTPS対応のサイトに接続してください。また、実運用ではThreadの代わりにCoroutines（コルーチン）を使うと、より安全かつ簡潔に非同期処理を書けます。

ステップ5：マニフェストへの権限追加

androidManifest.xml に以下のコードを追加します。Webサイトへアクセスするため、「INTERNET」パーミッションの宣言が必須です。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.q11">
   <uses-permission android:name="android.permission.INTERNET"/>
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:roundIcon="@mipmap/ic_launcher_round"
      android:supportsRtl="true"
      android:theme="@style/AppTheme">
      <activity android:name=".MainActivity">
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
      </activity>
   </application>
</manifest>

アプリを実行してみよう

それでは、アプリケーションを実行してみましょう。ここでは、実際のAndroidスマートフォンをパソコンに接続しているものとして説明します。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルをいずれか開き、ツールバーにある実行アイコン をクリックします。候補の中から接続したモバイルデバイスを選択すれば、実機の画面に解析結果が表示されます。

ボタンをタップすると、指定したWebサイトのタイトルと、ページ内に含まれる全リンクのURLおよびテキストが順次表示されるはずです。Jsoupのセレクタ構文（doc.select）を工夫すれば、特定のclass名やidを持つ要素のみを抽出することも可能なので、ぜひいろいろなパース処理に挑戦してみてください。