آنالایزر باندل قابل پخش

این صفحه نحوه استفاده از تحلیلگر بسته نرم افزاری Playables را پوشش می دهد.

دستورالعمل ها

آنالیزگر Playables باندل را می‌توان بر روی یک بسته بازی قابل اجرا اجرا کرد تا قبل از آپلود دارایی‌ها در Google Drive چندین اعتبارسنجی روی بسته بازی انجام دهد.

پیش نیازها

• پایتون 3 را نصب کنید.

اسکریپت را ایجاد کنید

1. برای ایجاد اسکریپت، دایرکتوری را در دستگاه خود شناسایی کنید (مثال: ~/scripts ).
2. با استفاده از کد نمونه ارائه شده ، فایلی به نام playables_bundle_analyzer.py در دستگاه خود ایجاد کنید.

اسکریپت را برای تجزیه و تحلیل بسته بازی اجرا کنید

1. یک پنجره ترمینال در دستگاه خود باز کنید و به دایرکتوری حاوی اسکریپت playables_bundle_analyzer.py بروید.

2. با اجرای این دستور اسکریپت را اجرا کنید و مسیر واقعی فهرست بسته بازی خود را جایگزین [GAME_DIRECTORY_PATH] کنید:

   python3 playables_bundle_analyzer.py [GAME_DIRECTORY_PATH]
   

3. یک گزارش تجزیه و تحلیل بسته نرم افزاری در دایرکتوری اسکریپت ایجاد می شود. نام آن playable_bundle_analysis_report.txt خواهد بود.

4. برای اطلاعات بیشتر در مورد اندازه بسته و الزامات نام فایل به پایداری و الزامات عملکرد مراجعه کنید.

کد

# Copyright 2024 Google LLC
#
# 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
#
#    https://www.apache.org/licenses/LICENSE-2.0
#
# 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.
"""Contains functions to analyze the Playable game bundles."""

import argparse
import os
import re
from typing import Dict, List, Union

SIZE_LIMITS = {
    "file": 31457280,  # 30 MiB
    "bundle": 262144000,  # 250 MiB
}

class BundleAnalyzer:
  """Class for analyzing Playable game bundles."""

  def __init__(self, directory_path):
    """Initializes the BundleAnalyzer object with the specified directory path.

    Args:
        directory_path: The path to the directory to analyze.
    """
    self.directory_path = directory_path
    self.total_size = 0
    self.filenames_with_issues = []
    self.files_too_large = []

  def analyze(self):
    """Analyzes the Playable game bundle and stores the results.

    This function iterates through the directory and its subdirectories,
    calculating the total size, and identifying files with
    issues like unsupported characters, duplicates, and exceeding size limits.
    """

    for root, _, files in os.walk(self.directory_path):
      for filename in files:
        file_path = os.path.join(root, filename)
        file_size = os.path.getsize(file_path)
        self.total_size += file_size

        if file_size > SIZE_LIMITS["file"]:
          self.files_too_large.append(file_path)

        if not is_valid_filename(filename):
          self.filenames_with_issues.append(file_path)

  def get_results(self) -> Dict[str, Union[List[str], List[str], int]]:
    """Returns a dictionary containing the analysis results.

    The dictionary includes information about the total number of files,
    files with issues, files exceeding size limits,
    and the total size of the bundle.
    """

    return {
        "filenames_with_issues": self.filenames_with_issues,
        "files_too_large": self.files_too_large,
        "total_size": self.total_size,
    }

def is_valid_filename(filename: str) -> bool:
  """Checks if the filename contains valid characters.

  Create a regular expression that matches allowed bundle file characters

  Args:
      filename: The filename to be validated.

  Returns:
      True if the filename is valid, False otherwise.
  """

  pattern = r"^[a-zA-Z0-9\-\._]+$"

  return bool(re.fullmatch(pattern, filename))

def main():
  """Main function that runs the BundleAnalyzer.

  Parses command line arguments, creates a BundleAnalyzer instance,
  runs the analysis, and output the results.
  """

  parser = argparse.ArgumentParser(description="Analyze file size")
  parser.add_argument("path", help="Path to file or directory")
  args = parser.parse_args()

  analyzer = BundleAnalyzer(args.path)
  analyzer.analyze()

  analysis_result = analyzer.get_results()

  with open("playable_bundle_analysis_report.txt", "w") as f:
    if analysis_result["filenames_with_issues"]:
      print(
          "Files with unsupported characters:"
          f" {analysis_result['filenames_with_issues']}",
          file=f,
      )

    if analysis_result["files_too_large"]:
      print(
          f"Files too large: {analysis_result['files_too_large']}",
          file=f,
      )

    if analysis_result["total_size"] > SIZE_LIMITS["bundle"]:
      print(
          f"Total bundle is too large:: {analysis_result['total_size']} bytes",
          file=f,
      )

if __name__ == "__main__":
  main()