Membuat Proyek SubQuery

... 2022-12-1 About 2 min

# Membuat Proyek SubQuery

Dalam panduan mulai cepat, kami dengan cepat menjalankan contoh untuk memberi Anda gambaran tentang apa itu SubQuery dan cara kerjanya. Di sini kita akan melihat lebih dekat alur kerja saat membuat proyek Anda dan file kunci yang akan Anda ikut sertakan.

# Alur Kerja Dasar

Beberapa contoh berikut akan menganggap Anda telah berhasil menginisialisasi paket starter di bagian Mulai cepat. Dari paket awal itu, kita akan menjalani proses standar untuk menyesuaikan dan mengimplementasikan proyek SubQuery Anda.

  1. Inisialisasi proyek Anda menggunakan subql init PROJECT_NAME.
  2. Perbarui file Manifest (project.yaml) untuk menyertakan informasi tentang blockchain Anda, dan entitas yang akan Anda petakan - lihat File Manifest
  3. Buat entitas GraphQL di skema Anda (schema.graphql) yang menentuakn bentuk data yang akan Anda ekstrak dan coba untuk kueri - lihat Skema GraphQL
  4. Tambahkan semua fungsi pemetaan (mis mappingHandlers.ts yang ingin Anda minta untuk ubah data chainnya ke entitas GraphQL yang sudah Anda tentukan - lihat Pemetaan
  5. Hasilkan, bentuk, dan terbitkan kode Anda ke Proyek SubQuery (atau jalankan di node lokal Anda) - lihat Menjalankan dan Mengkueri Proyek Pemula Anda di panduan mulai cepat kami.

# Struktur Direktori

Peta berikut ini memberikan gambaran struktur direktori proyek SubQuery saat perintah init berjalan.

- project-name
  L package.json
  L project.yaml
  L README.md
  L schema.graphql
  L tsconfig.json
  L docker-compose.yml
  L src
    L index.ts
    L mappings
      L mappingHandlers.ts
  L .gitignore
1
2
3
4
5
6
7
8
9
10
11
12

Sebagai contoh:

Struktur direktori SubQuery

# Pembuatan Kode

Kapan pun Anda mengubah entitas GraphQL Anda, Anda harus menghasilkan ulang direktori jenis Anda dengan perintah berikut.

yarn codegen
1

Ini akan membuat direktori baru (atau memperbarui yang sudah ada) src/types yang berisi kelas entitas yang dihasilkan untuk setiap jenis yang telah Anda tetapkan sebelumnya di schema.graphql. Kelas-kelas ini menyediakan akses entitas yang aman untuk memuat, membaca dan menulis ke bidang entitas - lihat selengkapnya tentang proses ini di Skema GraphQL.

# Bentuk

Untuk menjalankan Proyek SubQuery Anda di host Node SubQuery secara lokal, pertama-tama Anda perlu membentuk pekerjaan Anda.

Jalankan perintah bentuk dari direktori proyek.

# Opsi pembuatan alternatif

Kami mendukung opsi build tambahan untuk proyek subquery menggunakanmembangun subql.

Dengan ini, Anda dapat menentukan titik masuk tambahan untuk dibuat menggunakan bidang ekspor di package.json.

"name": "project-name",
"version": "1.0.0",
...
"exports": {
  "entry_one": "./src/entry_one.ts",
  "entry_renamed": "./src/entry_two.ts"
},
1
2
3
4
5
6
7

Kemudian dengan menjalankan subql build akan menghasilkan folder dist dengan struktur sebagai berikut:

- project-name
  L dist
    L entry_one.js
    L entry_renamed.js
    L index.js
1
2
3
4
5

Perhatikan bahwa itu akan membangun index.ts apakah ditentukan atau tidak di bidang ekspor.

Untuk informasi lebih lanjut tentang menggunakan ini termasuk tanda, lihat referensi cli (opens new window).

# Pencatatan

Metode console.log tidak lagi didukung. Sebagai gantinya, modul logger telah disuntikkan ke dalam tipe, yang berarti kami dapat mendukung logger yang dapat menerima berbagai level logging.

logger.info("Info level message");
logger.debug("Debugger level message");
logger.warn("Warning level message");
1
2
3

Untuk menggunakan logger.info atau logger.warn, cukup tempatkan baris tersebut ke dalam file pemetaan Anda.

logging.info

Untuk menggunakan logger.debug, diperlukan tanda tambahan. Tambahkan --log-level=debug ke baris perintah Anda.

Jika Anda menjalankan wadah buruh pelabuhan, tambahkan baris ini ke file docker-compose.yaml Anda.

logging.debug

Anda sekarang akan melihat logging baru di layar terminal.

logging.debug

Last update: December 1, 2022 23:29