WeChat ミニ プログラム開発チュートリアル

はじめに

アプリケーションアカウントの開発を開始する前に、公式の「ミニプログラム」チュートリアルをご覧ください。 (以下の内容は、WeChat が公式に発表した「ミニ プログラム」開発ガイドから引用しています)

このドキュメントでは、WeChat ミニ プログラムを作成する手順を段階的に説明し、ミニ プログラムの実際の効果を体験することができます。携帯電話で。このミニ プログラムのホームページには、ウェルカム メッセージと現在のユーザーの WeChat アバターが表示され、アバターをクリックすると、新しく開いたページで現在のミニ プログラムの起動ログが表示されます。

1. WeChat アプレットの AppID を取得します

まず、このドキュメントが表示される場合は、アカウントを招待して作成する必要があります。サービス アカウントまたはサブスクリプション アカウントの AppID を直接使用することはできないことに注意してください。 提供されたアカウントを使用して https://mp.weixin.qq.com にログインすると、Web サイトの「設定」-「開発者設定」で WeChat アプレットの AppID を確認できます。

注: 登録時にバインドされた管理者の WeChat ID を使用しない場合は、携帯電話でこのミニ プログラムをお試しください。次に、「Bind Developer」を操作する必要があります。つまり、「ユーザー ID - 開発者」モジュールで、ミニ プログラムを体験するために必要な WeChat ID をバインドします。デフォルトでは、このチュートリアルでは管理者の WeChat ID を使用してアカウントとエクスペリエンスを登録します。

2. プロジェクトを作成します

ミニプログラムの作成とコード編集を完了するには、開発者ツールを使用する必要があります。

開発者ツールがインストールされたら、WeChatを開いてQRコードをスキャンしてログインします。 「プロジェクト」の作成を選択し、上で取得したAppIDを入力し、「My First Project」などのローカルプロジェクト名（ミニプログラム名ではありません）を設定し、コードが保存されるディレクトリとしてローカルフォルダーを選択し、クリックするだけです。 "新しいプロジェクト"。

初心者が WeChat アプレットの基本的なコード構造を理解しやすくするために、作成プロセス中に、選択したローカル フォルダーが空のフォルダーである場合、開発者ツールはクイック スタート プロジェクトを作成する必要があるかどうかを確認するメッセージを表示します。 「はい」を選択すると、開発者ツールが開発ディレクトリに簡単なデモを生成するのに役立ちます。

プロジェクトが正常に作成されたら、プロジェクトをクリックして完全な開発者ツールインターフェイスを表示し、左側のナビゲーションをクリックして「編集」とその中の「デバッグ」でコードを表示および編集できます。 「プロジェクト」では、コードをテストして、WeChat クライアント上でミニ プログラムの効果をシミュレートし、携帯電話に送信して実際の効果をプレビューできます。

3. コードを書く

開発者ツールの左側のナビゲーションにある [編集] をクリックすると、このプロジェクトが初期化され、いくつかの簡単なコード ファイルが含まれていることがわかります。最も重要で不可欠なものは、app.js、app.json、および app.wxss です。このうち、.js サフィックスはスクリプト ファイル、.json サフィックスは設定ファイル、.wxss サフィックスはスタイル シート ファイルです。 WeChat アプレットはこれらのファイルを読み取り、アプレット インスタンスを生成します。

変更を容易にし、独自の WeChat アプレットを最初から開発できるように、これら 3 つのファイルの機能を簡単に理解しましょう。

app.jsはミニプログラムのスクリプトコードです。アプレットのライフサイクル関数を監視および処理し、このファイルでグローバル変数を宣言できます。この例では、ローカル データの同期ストレージや同期読み取りなど、MINA が提供する豊富な API を呼び出します。

app.json はアプレット全体のグローバル構成です。このファイルでは、ミニ プログラムを構成するページの構成、ミニ プログラムのウィンドウの背景色の構成、ナビゲーション バーのスタイルの構成、およびデフォルトのタイトルの構成を行うことができます。このファイルにはコメントを追加できないことに注意してください。

app.wxss は、アプレット全体のパブリック スタイル シートです。 app.wxss で宣言されたスタイル ルールをページ コンポーネントの class 属性で直接使用できます。

3. ページを作成します

このチュートリアルには、インデックス ページとログ ページ、つまりウェルカム ページとアプレット起動ログの表示ページの 2 つのページがあります。ページディレクトリ。 WeChat ミニ プログラムの各ページの [パス + ページ名] を app.json のページに記述する必要があり、ページ内の最初のページがミニ プログラムのホームページになります。

各ミニ プログラム ページは、同じパスにある同じ名前の 4 つの異なるサフィックス ファイル (index.js、index.wxml、index.wxss、index.json など) で構成されます。接尾辞 .js の付いたファイルはスクリプト ファイル、接尾辞 .json の付いたファイルは構成ファイル、接尾辞 .wxss の付いたファイルはスタイル シート ファイル、接尾辞 .wxml の付いたファイルはページ構造ファイルです。

index.wxml はページの構造ファイルです:

この例では、、、 を構築するために使用されます。ページ構造と対話型処理関数を定義します。

index.js はページのスクリプト ファイルです。このファイルでは、ページのライフサイクル関数の監視と処理、ミニ プログラム インスタンスの取得、データの宣言と処理、ページ インタラクション イベントへの応答などを行うことができます。

index.wxss はページのスタイル シートです:

ページのスタイル シートは必要ありません。ページ スタイル シートがある場合、ページのスタイル シートのスタイル ルールは app.wxss のスタイル ルールにカスケードされます。ページのスタイル シートを指定しない場合は、ページの構造ファイルの app.wxss で指定されたスタイル ルールを直接使用することもできます。

index.jsonはページの設定ファイルです:

ページの設定ファイルは必要ありません。ページ構成ファイルがある場合、ページ上の構成項目は、app.json のウィンドウ内の同じ構成項目を上書きします。ページ構成ファイルが指定されていない場合は、app.json のデフォルト構成がページで直接使用されます。

ログ ページの構造

ログ ページは、 制御タグを使用してコードを整理し、 で wx:for-items を使用してログ データをバインドします。拡張ノード

の結果は次のとおりです:

4. モバイル プレビュー

開発者ツールの左側のメニュー バーで [プロジェクト] を選択し、[プレビュー] をクリックしてコードをスキャンします。 WeChatクライアントの経験。

現在、プレビュー機能とアップロード機能はまだ利用できず、WeChatからの次の正式アップデートを待つ必要があります。

ご覧のとおり、WeChatが提供する公式開発ガイドは非常にシンプルで、多くの詳細、コード、機能が明確に表示されていないため、ボカジュンが力を発揮する時が来ました!開発チュートリアルが正式に始まります!

第 1 章: 準備

準備をすることが重要です。 WeChatアプリケーションアカウントを開発するには、事前にWeChat公式Webサイト（weixin.qq.com）から開発者ツールをダウンロードする必要があります。

1. 最新の WeChat 開発者ツールをダウンロードします。開くと、次のインターフェイスが表示されます。

2. [新しい Web+] プロジェクトをクリックすると、次の画面が表示されます。

3. ページ内のさまざまなコンテンツにご注意ください -

AppID: 公式の説明に従って入力してください。

アプリ名: プロジェクトの最も外側のフォルダーの名前を「ABC」とすると、後続のプロジェクトの内容はすべて「/ABC/...」ディレクトリに保存されます。

ローカル開発ディレクトリ: プロジェクトがローカルに保存されるディレクトリ。

注: 繰り返しになりますが、このプロジェクトをチーム メンバーと一緒に開発する場合は、共同開発の統一性を確保するために、同じディレクトリ名とローカル ディレクトリを使用することをお勧めします。以前にプロジェクトがある場合、インポート プロセスは上記と似ているため、再度説明しません。

4. すべての準備が完了したら、「新しいプロジェクト」ボタンをクリックし、ポップアップボックスで「OK」をクリックします。

5. 上の図に示すように、現時点では、WeChat 開発者ツールによって、WeChat アプリケーション プロジェクトに必要な基本コンテンツとフレームワーク構造が含まれる初期デモ プロジェクトが自動的に構築されています。プロジェクト名 (図の「カード」) をクリックしてプロジェクトに入ると、プロジェクト全体の基本構造が表示されます:

第 2 章: プロジェクトの構造

現在、WeChat には非常に高度な機能があります。公式アカウントの開設後、その人気は誰にでもわかり、h5 の急速な発展も促進されます。公式アカウント ビジネスのニーズがますます複雑になる中、アプリケーション アカウントの登場はまさにぴったりです。 。このドキュメントを 1 ～ 2 回読んだ後、私たちのチームは、DOM の操作からデータの操作に至るまで、開発者に提供する方法も包括的に変更されていることがわかりました。WeChat が提供するブリッジ ツールをベースにしてパブリック アカウントに多くの h5 を実装するのは困難です。実装されている機能はハイブリッド開発と似ていますが、ハイブリッド開発との違いは、WeChat のオープン インターフェイスがより厳格であり、その構造は外部フレームワークやプラグインを使用できないため、開発者が自由に使用できることです。 DOM の運用から完全に切り離され、開発の考え方が大きく変わりました。

労働者が仕事をうまくやりたいなら、まず道具を研ぐ必要があります。その中核となる機能を理解し、まずその動作プロセス全体を理解することが非常に重要です。

ライフサイクル:

index.js内:

開発者ツールのコンソールで確認できます:

ホームページコンソールでは、順序がアプリ起動であることがわかります。 - >アプリの表示-->onload-->onShow-->onReady。

まずアプリ全体の起動と表示です。アプリの起動はapp.jsで設定でき、その後各ページの読み込みと表示などに進みます。

箱の積み込みなど、ここで多くのことが処理できることが想像できます。

ルーティング:

ルーティングは常にプロジェクト開発の中核ポイントであり、実際、WeChat はルーティングに十分にカプセル化されており、3 つのジャンプ方法も提供していることがわかります。

wx.navigateTo(OBJECT): 現在のページを保持し、wx.navigateBack を使用して元のページに戻ります。

wx.redirectTo(OBJECT): 現在のページを閉じて、アプリケーション内のページにジャンプします。

wx.navigateBack(): 現在のページを閉じて、前のページに戻ります。

ルーティングに関しては、WeChat は非常によくパッケージ化されており、多くのフレームワークでは非常に面倒なルーティング設定を行う必要がありません。

コンポーネント:

今回のWeChatは、コンポーネントの提供という点でも非常に包括的であり、基本的にプロジェクトのニーズを満たしているため、開発速度が非常に速く、開発前に何度も注意深く閲覧することができます。効率は非常に良くなります。

その他:

過去の JS プラグインは基本的にすべて 1 つの形式で存在していたので、ネイティブの JS プラグインでさえも基本的に使用できません。 -operation dom、および WeChat 今回のアプリケーション アカウントのアーキテクチャでは、DOM の操作は許可されておらず、これまで使い慣れていた動的に設定される rem.js さえもサポートされていません。

今回、WeChatはチャットに直接使用できるWebSocketも提供します。開発の余地はたくさんあります。

パブリックアカウントと比較すると、アプリケーションアカウントの開発はコンポーネントベースで構造化され、多様化していることがわかりました。新世界はいつも驚きに満ちており、さらに多くのイースターエッグが皆さんの発見を待っています。

それでは、いくつかの簡単なコードに取り組み始めましょう!

1. プロジェクトフォルダーを見つけてエディターにインポートします。ここでは、Sublime Text エディターを使用しました。開発習慣に基づいて、お気に入りのエディターを選択できます。

2. 次に、プロジェクトの内容に応じてプロジェクトの構造を調整する必要があります。サンプルプロジェクトでは、「card_course」ディレクトリには主に「tabBar」ページとアプリケーションのいくつかの設定ファイルが含まれています。

3. サンプル プロジェクトの「tabBar」は 5 つのメニュー ボタンです。

4. これらの 5 つのメニューを設定するための「app.json」ファイルを見つけます。コード行で「"tabBar"」を見つけます:

你可以根据实际项目需求更改，其中：

「Color」是底部字体颜色，「selectedColor」是切换到该页面高亮颜色，「borderStyle」是切换菜单上面的一条线的颜色，「backgroundColor」是底部菜单栏背景颜色。文字描述较为抽象，建议你一一调试并查看其效果，加深印象。

「“list”」下的代码顺序必须依次放置，不能随便更改。

「”pagePath”」之后的文件名内，「.wxml」后缀被隐藏起来了，这是微信开发代码中人性化的一点——帮你节约写代码的时间，无须频繁声明文件后缀。

「”iconPath”」为未获得显示页面的图标路径，这两个路径可以直接是网络图标。

「”selectedIconPath”」为当前显示页面高亮图标路径，可以去掉，去掉之后会默认显示为「”iconPath”」的图标。

「”Text”」为页面标题，也可以去掉，去掉之后纯显示图标，如只去掉其中一个，该位置会被占用。

注意：微信的底部菜单最多支持五栏（五个 icons），所以在你设计微信应用的 UI 和基本架构时就要预先考虑好菜单栏的排布。

5. 根据以上代码规则，我做好了示例项目的基本架构，供你参考：

6. 「Json」文件配置好后，「card_course」的基本结构入上图所示，不需要的子集都可以暂时删除，缺少的子集则需要你主动新建。删除子集时记得顺带检查一下「app.json」里的相关内容是否已经一并删除。

注意：我个人建议你新建一个「wxml」文件的同时，把对应的「js」和「wxss」文件一起新建好，因为微信应用号的配置特点就是解析到一个「wxml」文件时，会同时在同级目录下找到同文件名的「js」和「wxss」文件，所以「js」文件需及时在「app.json」里预先配置好。

编写「wxml」时，根据微信应用号提供的接口编码即可，大部分就是以前的「div」，而我们现在就用「view」即可。需要用其它子集时，可以根据微信提供的接口酌情选择。

使用「class」名来设置样式，「id」名在这里基本没有什么用处。主要操作数据，不操作「dom」。

7. 以上是示例项目首页的「wxml」编码。从图中就可以看出，实现一个页面代码量非常少。

8. 「Wxss」文件是引入的样式文件，你也可以直接在里面写样式，示例中采用的是引入方式：

9. 修改代码后刷新一次，可以看到未设背景的「view」标签直接变成了粉色。

注意：修改「wxml」和「wxss」下的内容后，直接 F5 刷新就能直接看到效果，修改「js」则需点击重启按钮才能看到效果。

10. 另外，公共样式可以在「app.wxss」里直接引用。

11. 「Js」文件需要在「app.json」文件的「”page”」里预先配置好。为了项目结构清晰化，我在示例项目中的「index」首页同级目录新建其它四个页面文件，具体如下：

经过以上步骤，案例中的五个底部菜单就全部配置完毕了。

更多WeChat ミニ プログラム開発チュートリアル相关文章请关注PHP中文网！